该文已授权公众号 「码个蛋」,转载请指明出处
上一篇讲完 Flutter
中的一些基本部件,这篇就先填完上篇留下的没写的 AppBar
的坑,以及 Scaffold
其他参数的使用,在开始前,先补一张缩略版的脑图
完整版放在网盘,小伙伴自己下载。 完整版脑图,提取码:el9q,xmind 文件 提取码:1o5d
AppBar(part2)
这一部分,我们只关注 Scaffold
中的 AppBar
剩下的还是埋坑【坑4】(/内牛满面,居然已经埋了那么多坑了,坑虽多,代码还是要继续的),因为稍后会用到 StatefulWidget
的属性,所以就直接先使用了,和 StatelessWidget
区别用法可以这么记 需要数据更新的界面用 StatefulWidget
,当然也不是绝对的,就是之前留的【坑1】所说的状态管理
class HomePage extends StatefulWidget {
@override
_HomePageState createState() => _HomePageState();
}
class _HomePageState extends State {
List _abs = ['A', 'B', 'S'];
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
centerTitle: true, // 标题内容居中
automaticallyImplyLeading: false, // 不使用默认
leading: Icon(Icons.menu, color: Colors.red, size: 30.0), // 左侧按钮
flexibleSpace: Image.asset('images/app_bar_hor.jpg', fit: BoxFit.cover), // 背景
title: Text('AppBar Demo', style: TextStyle(color: Colors.red)), // 标题内容
// 末尾的操作按钮列表
actions: [
PopupMenuButton(
onSelected: (val) => print('Selected item is $val'),
icon: Icon(Icons.more_vert, color: Colors.red),
itemBuilder: (context) =>
List.generate(_abs.length, (index) => PopupMenuItem(value: _abs[index], child: Text(_abs[index]))))
],
),
);
}
}
最后的效果图,未点击右侧按钮如左侧所示,点击右侧按钮会弹出相应的 mune
该部分代码查看 app_bar_main.dart
文件
看到效果图,相信很多小伙伴会吐槽,「**,上面那层半透明的啥玩意,那么丑」,接下来我们来解决这个问题,修改 void main
方法
void main() {
runApp(DemoApp());
// 添加如下代码,使状态栏透明
if (Platform.isAndroid) {
var style = SystemUiOverlayStyle(statusBarColor: Colors.transparent);
SystemChrome.setSystemUIOverlayStyle(style);
}
}
关闭后重新运行,就可以看到那层丑丑的「半透明蒙层」没有了。
PopupMenuButton
这个部件,还是按照惯例看构造函数
// itemBuilder
typedef PopupMenuItemBuilder = List> Function(BuildContext context);
// onSelected
typedef PopupMenuItemSelected = void Function(T value);
const PopupMenuButton({
Key key,
@required this.itemBuilder, // 用于定义 menu 列表,需要传入 List>
this.initialValue, // 初始值,是个泛型 T,也就是类型和你传入的值有关
this.onSelected, // 选中 item 的回调函数,返回 T value,例如选中 `s` 则返回 s
this.onCanceled, // 未选择任何 menu,直接点击外侧使 mune 列表关闭的回调
this.tooltip, // 长按时的提示
this.elevation = 8.0,
this.padding = const EdgeInsets.all(8.0),
this.child, // 用于自定义按钮的内容
this.icon, // 按钮的图标
this.offset = Offset.zero, // 展示时候的便宜,Offset 需要传入 x,y 轴偏移量,会根据传入值平移
})
AppBar - bottom
AppBar
还有个 bottom
属性没讲,因为 bottom
这个属性和图片背景一起使用会比较丑,所以就单独拎出来讲,我们直接在原来的代码上修改
// 这里需要用 with 引入 `SingleTickerProviderStateMixin` 这个类
class _HomePageState extends State with SingleTickerProviderStateMixin {
List _abs = ['A', 'B', 'S'];
TabController _tabController; // TabBar 必须传入这个参数
@override
void initState() {
super.initState();
// 引入 `SingleTickerProviderStateMixin` 类主要是因为 _tabController 需要传入 vsync 参数
_tabController = TabController(length: _abs.length, vsync: this);
}
@override
void dispose() {
// 需要在界面 dispose 之前把 _tabController dispose,防止内存泄漏
_tabController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
centerTitle: true,
automaticallyImplyLeading: false,
leading: Icon(Icons.menu, color: Colors.red, size: 30.0),
// flexibleSpace: Image.asset('images/app_bar_hor.jpg', fit: BoxFit.cover),
title: Text('AppBar Demo', style: TextStyle(color: Colors.red)),
actions: [
PopupMenuButton(
offset: Offset(50.0, 100.0),
onSelected: (val) => print('Selected item is $val'),
icon: Icon(Icons.more_vert, color: Colors.red),
itemBuilder: (context) =>
List.generate(_abs.length, (index) => PopupMenuItem(value: _abs[index], child: Text(_abs[index]))))
],
bottom: TabBar(
labelColor: Colors.red, // 选中时的颜色
unselectedLabelColor: Colors.white, // 未选中颜色
controller: _tabController,
isScrollable: false, // 是否固定,当超过一定数量的 tab 时,如果一行排不下,可设置 true
indicatorColor: Colors.yellow, // 导航的颜色
indicatorSize: TabBarIndicatorSize.tab, // 导航样式,还有个选项是 TabBarIndicatorSize.label tab 时候,导航和 tab 同宽,label 时候,导航和 icon 同宽
indicatorWeight: 5.0, // 导航高度
tabs: List.generate(_abs.length, (index) => Tab(text: _abs[index], icon: Icon(Icons.android)))), // 导航内容列表
),
);
}
}
最终的效果图如下:
PageView + TabBar
那么如何通过 TabBar
切换界面呢,这边我们需要用到 PageView
这个部件,当然还有别的部件,例如 IndexStack
等,小伙伴可以自己尝试使用别的,这边通过 PageView
和 TabBar
进行关联,带动页面切换,PageViede
的属性参数相对比较简单,这边就不贴啦。最终的效果我们目前只展示一个文字即可,我们先定义一个通用的切换界面
class TabChangePage extends StatelessWidget {
// 需要传入的参数
final String content;
// TabChangePage(this.content); 不推荐这样写构造方法
// 推荐用这样的构造方法,key 可以作为唯一值查找
TabChangePage({Key key, this.content}) : super(key: key);
@override
Widget build(BuildContext context) {
// 仅展示传入的内容
return Container(
alignment: Alignment.center, child: Text(content, style: TextStyle(color: Theme.of(context).primaryColor, fontSize: 30.0)));
}
}
定义通用界面后,就可以作为 PageView
的子界面传入并展示
class HomePage extends StatefulWidget {
@override
_HomePageState createState() => _HomePageState();
}
class _HomePageState extends State with SingleTickerProviderStateMixin {
List _abs = ['A', 'B', 'S'];
TabController _tabController;
// 用于同 TabBar 进行联动
PageController _pageController;
@override
void initState() {
super.initState();
_tabController = TabController(length: _abs.length, vsync: this);
_pageController = PageController(initialPage: 0);
_tabController.addListener(() {
// 判断 TabBar 是否切换位置了,如果切换了,则修改 PageView 的显示
if (_tabController.indexIsChanging) {
// PageView 的切换通过 controller 进行滚动
// duration 表示切换滚动的时长,curve 表示滚动动画的样式,
// flutter 已经在 Curves 中定义许多样式,可以自行切换查看效果
_pageController.animateToPage(_tabController.index,
duration: Duration(milliseconds: 300), curve: Curves.decelerate);
}
});
}
@override
void dispose() {
_tabController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
centerTitle: true,
automaticallyImplyLeading: false,
leading: Icon(Icons.menu, color: Colors.red, size: 30.0),
// flexibleSpace: Image.asset('images/app_bar_hor.jpg', fit: BoxFit.cover),
title: Text('AppBar Demo', style: TextStyle(color: Colors.red)),
actions: [
PopupMenuButton(
offset: Offset(50.0, 100.0),
onSelected: (val) => print('Selected item is $val'),
icon: Icon(Icons.more_vert, color: Colors.red),
itemBuilder: (context) =>
List.generate(_abs.length, (index) => PopupMenuItem(value: _abs[index], child: Text(_abs[index]))))
],
bottom: TabBar(
labelColor: Colors.red,
unselectedLabelColor: Colors.white,
controller: _tabController,
isScrollable: false,
indicatorColor: Colors.yellow,
indicatorSize: TabBarIndicatorSize.tab,
indicatorWeight: 5.0,
tabs: List.generate(_abs.length, (index) => Tab(text: _abs[index], icon: Icon(Icons.android)))),
),
// 通过 body 来展示内容,body 可以传入任何 Widget,里面就是你需要展示的界面内容
// 所以前面留下 Scaffold 中 body 部分的坑就解决了
body: PageView(
controller: _pageController,
children:
_abs.map((str) => TabChangePage(content: str)).toList(), // 通过 Map 转换后再通过 toList 转换成列表,效果同 List.generate
onPageChanged: (position) {
// PageView 切换的监听,这边切换 PageView 的页面后,TabBar 也需要随之改变
// 通过 tabController 来改变 TabBar 的显示位置
_tabController.index = position;
},
),
);
}
}
最终的效果图就不贴了,可以发现滑动 PageView
或者点击切换 TabBar
的位置,界面显示的内容都会随之改变,同时,解决前面 Scaffold
留下 body
属性没讲的一个坑,就剩下 drawer
、 bottomNavigationBar
属性没讲了,在解决这两个坑之前,我们先处理下另一个问题
Scaffold
能够使我们快速去搭建一个界面,但是,并不是所有的界面都需要 AppBar
这个标题,那么我们就不会传入 appBar
的属性,我们注释 _HomePageState
中 Scaffold
的 appBar
传入值,把 body
传入的 PageView
修改成单个 TabChangePage
,然后把 TabChangePage
这个类做下修改,把 Container
的 aligment
属性也注释了,这样显示的内容就会显示在左上角
// _HomePageState
// ..
@override
Widget build(BuildContext context) {
return Scaffold(body: TabChangePage(content: 'Content'));
}
class TabChangePage extends StatelessWidget {
final String content;
TabChangePage({Key key, this.content}) : super(key: key);
@override
Widget build(BuildContext context) {
return Container(child: Text(content, style: TextStyle(color: Theme.of(context).primaryColor, fontSize: 30.0)));
}
}
然后运行下,「**,文字怎么被状态栏给挡了...」
不要慌,静下心喝杯茶,眺望下远方,这里就需要用 SafeArea
来处理了,在 TabChangePage
的 Container
外层加一层 SafeArea
@override
Widget build(BuildContext context) {
return SafeArea(
child:
Container(child: Text(content, style: TextStyle(color: Theme.of(context).primaryColor, fontSize: 30.0))));
}
然后重新运行,一切正常,SafeArea
的用途可以看下源码的解释
/// A widget that insets its child by sufficient padding to avoid intrusions by
/// the operating system.
///
/// For example, this will indent the child by enough to avoid the status bar at
/// the top of the screen.
翻译过来大概就是「给子部件和系统点击无效区域留有足够空间,比如状态栏和系统导航栏」,SafeArea
可以很好解决刘海屏覆盖页面内容的问题,那么到目前为止,AppBar
的一些坑就说的差不多了,就要解决剩下的坑了
Scaffold - Drawer
drawer
同 endDrawer
属性是一样的,除了滑动的方向,Drawer
这个组件也相对比较简单,只要传入一个 child
即可,在展示之前,先对 appBar
做下处理,设置 leading
为系统默认,点击 leading
的时候 Drawer
就可以滑出来了,当然手动滑也可以
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
centerTitle: true,
// automaticallyImplyLeading: false,
// leading: Icon(Icons.menu, color: Colors.red, size: 30.0),
// flexibleSpace: Image.asset('images/app_bar_hor.jpg', fit: BoxFit.cover),
title: Text('AppBar Demo', style: TextStyle(color: Colors.red)),
actions: [
PopupMenuButton(
offset: Offset(50.0, 100.0),
onSelected: (val) => print('Selected item is $val'),
icon: Icon(Icons.more_vert, color: Colors.red),
itemBuilder: (context) =>
List.generate(_abs.length, (index) => PopupMenuItem(value: _abs[index], child: Text(_abs[index]))))
],
bottom: TabBar(
labelColor: Colors.red,
unselectedLabelColor: Colors.white,
controller: _tabController,
isScrollable: false,
indicatorColor: Colors.yellow,
indicatorSize: TabBarIndicatorSize.tab,
indicatorWeight: 5.0,
tabs: List.generate(_abs.length, (index) => Tab(text: _abs[index], icon: Icon(Icons.android)))),
),
// body ....
drawer: Drawer(
// 记得要先添加 `SafeArea` 防止视图顶到状态栏下面
child: SafeArea(
child: Container(
child: Text('Drawer', style: TextStyle(color: Theme.of(context).primaryColor, fontSize: 30.0)),
)),
),
);
// return Scaffold(body: TabChangePage(content: 'Content'));
}
最终的效果图也不贴了,当手势从左侧滑出或者点击 leading
图标,抽屉就出来了
AppBar - bottomNavigationBar
bottomNavigarionBar
可以传入一个 BottomNavigationBar
实例,BottomNavigationBar
需要传入 BottomNavigationBarItem
列表作为 items
,但是这边为了实现一个 bottomNavigationBar
和 floatingActionButton
一个特殊的组合效果,我们不使用 BottomNavigationBar
,换做 BottomAppBar
,直接上代码吧
@override
Widget build(BuildContext context) {
return Scaffold(
/// 一样的代码省略....
bottomNavigationBar: BottomAppBar(
shape: CircularNotchedRectangle(),
child: Row(
mainAxisSize: MainAxisSize.max,
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: [
IconButton(icon: Icon(Icons.android, size: 30.0, color: Theme.of(context).primaryColor), onPressed: () {}),
IconButton(icon: Icon(Icons.people, size: 30.0, color: Theme.of(context).primaryColor), onPressed: () {})
],
),
),
floatingActionButton:
FloatingActionButton(onPressed: () => print('Add'), child: Icon(Icons.add, color: Colors.white)),
// FAB 的位置,一共有 7 中位置可以选择,centerDocked, endDocked, centerFloat, endFloat, endTop, startTop, miniStartTop,这边选择悬浮在 dock
floatingActionButtonLocation: FloatingActionButtonLocation.centerDocked,
);
最终的效果图:
既然提到了 StatefulWidget
,顺带提下两种比较简单的部件,也算是基础部件吧。CheckBox
、CheckboxListTile
,Switch
、SwitchListTile
因为比较简单,就直接上代码了,里面都有完整的注释
class CheckSwitchDemoPage extends StatefulWidget {
@override
_CheckSwitchDemoPageState createState() => _CheckSwitchDemoPageState();
}
class _CheckSwitchDemoPageState extends State {
var _isChecked = false;
var _isTitleChecked = false;
var _isOn = false;
var _isTitleOn = false;
@override
void initState() {
super.initState();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('Check Switch Demo'),
),
body: Column(children: [
Row(
children: [
Checkbox(
// 是否开启三态
tristate: true,
// 控制当前 checkbox 的开启状态
value: _isChecked,
// 不设置该方法,处于不可用状态
onChanged: (checked) {
// 管理状态值
setState(() => _isChecked = checked);
},
// 选中时的颜色
activeColor: Colors.pink,
// 这个值有 padded 和 shrinkWrap 两个值,
// padded 时候所占有的空间比 shrinkWrap 大,别的原谅我没看出啥
materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
),
/// 点击无响应
Checkbox(value: _isChecked, onChanged: null, tristate: true)
],
),
Row(
children: [
Switch(
// 开启时候,那个条的颜色
activeTrackColor: Colors.yellow,
// 关闭时候,那个条的颜色
inactiveTrackColor: Colors.yellow[200],
// 设置指示器的图片,当然也有 color 可以设置
activeThumbImage: AssetImage('images/ali.jpg'),
inactiveThumbImage: AssetImage('images/ali.jpg'),
// 开始时候的颜色,貌似会被 activeTrackColor 顶掉
activeColor: Colors.pink,
materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
value: _isOn,
onChanged: (onState) {
setState(() => _isOn = onState);
}),
/// 点击无响应
Switch(value: _isOn, onChanged: null)
],
),
CheckboxListTile(
// 描述选项
title: Text('Make this item checked'),
// 二级描述
subtitle: Text('description...description...\ndescription...description...'),
// 和 checkbox 对立边的部件,例如 checkbox 在头部,则 secondary 在尾部
secondary: Image.asset('images/ali.jpg', width: 30.0, height: 30.0),
value: _isTitleChecked,
// title 和 subtitle 是否为垂直密集列表中一员,最明显就是部件会变小
dense: true,
// 是否需要使用 3 行的高度,该值为 true 时候,subtitle 不可为空
isThreeLine: true,
// 控制 checkbox 选择框是在前面还是后面
controlAffinity: ListTileControlAffinity.leading,
// 是否将主题色应用到文字或者图标
selected: true,
onChanged: (checked) {
setState(() => _isTitleChecked = checked);
},
),
SwitchListTile(
title: Text('Turn On this item'),
subtitle: Text('description...description...\ndescription...description...'),
secondary: Image.asset('images/ali.jpg', width: 30.0, height: 30.0),
isThreeLine: true,
value: _isTitleOn,
selected: true,
onChanged: (onState) {
setState(() => _isTitleOn = onState);
})
]),
);
}
}
该部分代码查看 checkbox_swicth_main.dart
文件
终于这节把 Scaffold
留下的坑都填完了,然后又讲了两种基础部件,下节要填留下的别的坑了,目测还留了 2 个大坑,那就等以后继续解决吧~
最后代码的地址还是要的:
文章中涉及的代码:demos
基于郭神
cool weather
接口的一个项目,实现BLoC
模式,实现状态管理:flutter_weather一个课程(当时买了想看下代码规范的,代码更新会比较慢,虽然是跟着课上的一些写代码,但是还是做了自己的修改,很多地方看着不舒服,然后就改成自己的实现方式了):flutter_shop
如果对你有帮助的话,记得给个 Star,先谢过,你的认可就是支持我继续写下去的动力~