Flutter入门进阶之旅（十六）Scaffold 脚手架

发表于

在本栏的前面章节的学习中，我们基本上把Flutter中所有的常用布局、组件包括多页面跳转路由都介绍过了，细心的读者可能会发现在前面的课程中我们每次新建一个Flutter Page的时候都会在根布局的build方法中直接return一个Scaffold然后，再通过配置Scaffold中的相关属性来快速的渲染页面布局：没错Scaffold的出现就是为了帮助我们实现基本的 Material Design 布局结构，简化我们页面开发工作，我们可以形象的把Scaffold理解为页面搭建的脚手架

课程学习目标

了解并掌握Scaffold中提供的快速搭建页面的脚手架方法
  • appBar: 显示在界面顶部的一个菜单导航栏
  • body：页面中显示主要内容的区域，可任意指定Widget
  • floatingActionButton： 悬浮按钮（类似原生Android中的floatingActionButton）
  • drawer、endDrawer：分别用于在左右两侧边栏展示抽屉菜单
  • bottomNavigationBar：显示在底部的导航栏按钮栏

在Flutter脚手架中给我们提供了上述用于快速构建页面的常用属性，开发者可根据自己的页面需求，选择性的引入不同属性达到定制出不同UI呈现的目的，关于Scaffold中的其他属性，我就不逐个讲解了，下面我结合代码跟大家一块测试下上述常用方法。

Scaffold课程完整效果图

在这里插入图片描述
下面我拆分每一部分组件，详细对Scaffold中常用方法做讲解说明。

1. appBar

在前面的每一节课程中我们都可以找到appBar的身影，但是由于之前的课程重点不在appBar上，所以我们并没有对appBar展开过多的介绍，就仅仅是作为展示页面标题使用。

我们先来看看Scaffold源码中对appBar的解释说明：一个展示在Scaffold顶部的APP Bar

1
2
/// An app bar to display at the top of the scaffold.
final PreferredSizeWidget appBar;

通常我们会给根据不同的业务场景设置不同的AppBar，关于AppBar的构造方法大部分属性读者都可以根据属性名自解释，我就不贴出来赘述了，下面我举几个常用的例子

1.1 设置Title
1
2
3
appBar: AppBar(
        title: Text("Scaffold 脚手架"),
       ),

标题居中：

1
2
3
4
appBar: AppBar(
        title: Text("Scaffold 脚手架"),
        centerTitle: true,
       ),

默认标题位置 标题居中

1.2设置左上角返回按钮

从上面的代码以及图片中我们看到Scaffold中默认为我们在appBar上指定了一个返回的箭头，点击箭头返回上一页，当然我们可以通过leading属性自定义左上角的图标，但是当我们指定了leading点击事件就需要我们自己单独处理了，也就是说，指定了leading之后，我们就没办法在点击箭头的时候结束当前页，但是我们可以自己实现这一操作。

1
2
3
4
5
6
7
appBar: AppBar(
         leading: GestureDetector(child: Icon(Icons.print),onTap: (){
           Navigator.of(context).pop();
         }),  //添加leading之后需要重写点击事件唤
         title: Text("Scaffold 脚手架"),
         centerTitle: true,
        ),

自定义左侧按钮点击事件

1.3 右侧溢出菜单

在Flutter中我们通过Appbar的 actions属性设置菜单项，一般重要的菜单选项我们会直接放在右边bar上显示，非重要功能选项我们会通过PopupMenuButton以三个小点的形式放进折叠菜单里，下面我们结合源码看下效果图，读者一看便知。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
appBar: AppBar(
          leading: GestureDetector(child: Icon(Icons.print),onTap: (){
            Navigator.of(context).pop();
          }),  //添加leading之后需要重写点击事件唤起抽屉菜单
          title: Text("Scaffold 脚手架"),
          actions: <Widget>[
            IconButton(icon: Icon(Icons.message), onPressed: () {}),
            IconButton(icon: Icon(Icons.access_alarm), onPressed: () {}),
            PopupMenuButton(
                onSelected: (String value) {
                  print('-----------------$value');
                },
                itemBuilder: (BuildContext context) => [
                      new PopupMenuItem(value: "选项一的内容", child: new Text("选项一")),
                      new PopupMenuItem(value: "选项二的内容", child: new Text("选项二")),
                      new PopupMenuItem(value: "选项三的内容", child: new Text("选项三")),
                    ])
          ],
          ),

右侧菜单

1.4 标题栏底部TabBar

在原生Android中我们很熟悉的就是利用TabLayout设置标题栏下方的tab切换效果，在Flutter中我们通过给AppBar的bottom属性设置TabBar来完成这一效果。

1
2
3
4
5
6
7
8
9
    bottom: TabBar(
            controller: _tabController,
            tabs: topTabLists
                .map((element) => Tab(
                      text: element,
                    ))
                .toList(),
//            onTap: (index) => {},
          )),

使用TabBar必须传入controller属性，我们通过initState()方法初始化_tabController

1
2
3
4
5
6
@override
void initState() {
  super.initState();
  //初始化顶部TabController
  _tabController = TabController(length: topTabLists.length, vsync: this);
}

在这里插入图片描述
Tab属性设置icon图标+文字

1
2
3
4
5
6
7
8
9
10
 bottom: TabBar(
            controller: _tabController,
            tabs: topTabLists
                .map((element) => Tab(
                      text: element,
                      icon: Icon(Icons.print),
                    ))
                .toList(),
//            onTap: (index) => {},
          )),

在这里插入图片描述

2.body部分

根据Scaffold页面布局的上下顺序，下面我们讲解第二部分body部分。关于body部分在前面的课程中，我们使用了很多次了，也没什么需要特别说的地方，这里我就不展开介绍了，body作为一个页面的主要视图部分，可以传入任意指定的Widget，可现实在屏幕中央，这里我就不过多赘述了。

1
2
3
body: Container(
      child: Text("内容区域"),
    ),

3.抽屉菜单

在文章开题的时候，我提到了抽屉菜单可以通过drawer、endDrawer指定左右两侧打开的抽屉菜单。下面我们就来看下效果。

左侧抽屉

1
drawer: MyDrawer(), //MyDrawer详细代码在下面

右侧抽屉

1
endDrawer: MyDrawer(), //MyDrawer详细代码在下面

左侧抽屉 右侧抽屉
上述抽屉相关的MyDrawer代码如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
class MyDrawer extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Drawer(
        child: Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: <Widget>[
        Padding(
          padding: const EdgeInsets.only(top: 88.0, bottom: 30.0),
          child: Row(
            children: <Widget>[
              Padding(
                padding: const EdgeInsets.symmetric(horizontal: 16.0),
                child: ClipOval(
                  child: Image.network(
                    "https://avatar.csdn.net/6/0/6/3_xieluoxixi.jpg",
                    width: 60,
                  ),
                ),
              ),
              Text(
                "谢栋",
                style: TextStyle(fontWeight: FontWeight.bold),
              )
            ],
          ),
        ),
        Expanded(
          child: ListView(
            children: <Widget>[
              ListTile(
                leading: const Icon(Icons.settings),
                title: const Text('个人设置'),
              ),
              ListTile(
                leading: const Icon(Icons.live_help),
                title: const Text('帮助说明'),
              ),
              ListTile(
                leading: const Icon(Icons.settings),
                title: const Text('个人设置'),
              ),
              ListTile(
                leading: const Icon(Icons.live_help),
                title: const Text('帮助说明'),
              ),
            ],
          ),
        )
      ],
    ));
  }
}

4.floatingActionButton

floatingActionButton在前面讲解Button章节中我们讲解过，知识点也比较简单，就是在页面布局快速构建出一个悬浮按钮。

1
2
3
4
5
6
floatingActionButton: FloatingActionButton(
        onPressed: (){
          print("---------");
        },
        child: Icon(Icons.add),
      ),

在这里插入图片描述
我们可以通过在Scaffold脚手架中指定floatingActionButtonLocation来指定floatingActionButton显示的位置。
在这里插入图片描述
各个位置属性基本见名知意，我就不逐个写效果图展示了，下面只贴上一个悬停在底部导航栏上的样式。

1
2
3
floatingActionButtonLocation:
         FloatingActionButtonLocation.centerDocked, //设置FloatingActionButton的位置
   );

在这里插入图片描述

5.底部导航栏 bottomNavigationBar

bottomNavigationBar的使用场景还比较多，一般我们的多页面app都会通过底部的Tab来切换App首页展示的不同内容，在Flutter的Scaffold中为我们提供了快捷用于构建底部Tab的方法，我们通过给BottomNavigationBar的Items属性设置需要展示的BottomNavigationBarItem数组即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
bottomNavigationBar: BottomNavigationBar(
       //不设置该属性多于三个不显示颜色
       type: BottomNavigationBarType.fixed,
       items: [
         BottomNavigationBarItem(icon: Icon(Icons.home), title: Text("首页")),
         BottomNavigationBarItem(icon: Icon(Icons.message), title: Text("消息")),
         BottomNavigationBarItem(
             icon: Icon(Icons.add_a_photo), title: Text("动态")),
         BottomNavigationBarItem(icon: Icon(Icons.person), title: Text("我的"))
       ],
       currentIndex: _currentBottomIndex,
       fixedColor: Colors.blue,
       onTap: (index) => _onBottomTabChange(index),
     ),

在这里插入图片描述
这里有个细节需要说一下，有读者私下里问我说设置了bottomNavigationBar的属性其中tab为三个的时候可以正常显示，但是多于三个就变成白色了，不能正常显示。 正常显示 显示白色，切换效果不明显

这里我从源码角度上给读者解读一下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
/// If [fixedColor] is null then the theme's primary color,
/// [ThemeData.primaryColor], is used. However if [BottomNavigationBar.type] is
/// [BottomNavigationBarType.shifting] then [fixedColor] is ignored.
BottomNavigationBar({
  Key key,
  @required this.items,
  this.onTap,
  this.currentIndex = 0,
  BottomNavigationBarType type,
  this.fixedColor,
  this.iconSize = 24.0,
}) : assert(items != null),
     assert(items.length >= 2),
     assert(
      items.every((BottomNavigationBarItem item) => item.title != null) == true,
      'Every item must have a non-null title',
     ),
     assert(0 <= currentIndex && currentIndex < items.length),
     assert(iconSize != null),
     type = type ?? (items.length <= 3 ? BottomNavigationBarType.fixed : BottomNavigationBarType.shifting),
     super(key: key);

在这里插入图片描述
从源码上的这段标红线的地方，我们可以读到，当BottomNavigationBar中的items数量小于等于3时，type为BottomNavigationBarType.fixed，大于3则为BottomNavigationBarType.shifting，所以我们只需在代码中重载type属性，大于3个的时候设置type值为BottomNavigationBarType.fixed即可。我在一开始的代码注释中也解释了这个问题。

UI小特效
在实现底部导航栏时，Flutter还为我们提供了一个Material组件中的类似‘“镶嵌”效果，使用BottomAppBar配合FloatingActionButton完成，文字描述可能云里雾里的。

一图胜千言
悬浮按钮镶嵌在Bar上

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
//与FloatingActionButton配合实现"打洞"效果
      bottomNavigationBar: BottomAppBar(
        color: Colors.white,
        shape: CircularNotchedRectangle(), // 底部导航栏打一个圆形的洞
        child: Row(
          children: [
            Tab(text: "首页", icon: Icon(Icons.home)),
            Tab(text: "消息", icon: Icon(Icons.message)),
            Tab(text: "动态", icon: Icon(Icons.add_a_photo)),
            Tab(text: "我的", icon: Icon(Icons.person)),

          ],
          mainAxisAlignment: MainAxisAlignment.spaceAround, //均分底部导航栏横向空间
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () => _onFabClick,
        child: Icon(Icons.add),
      ),
      floatingActionButtonLocation:
          FloatingActionButtonLocation.centerDocked, //设置FloatingActionButton的位置
    );

虽然我们在上面借助BottomNavigationBar也实现了类似的效果，但是前者是直接压在导航栏上面的，而后者是嵌入进去的，效果更逼真。读者可对比下方的效果图。

直接压在导航栏上 悬浮按钮镶嵌在Bar上
限于篇幅问题，本篇博文的完整代码我就不在此贴出来了，有需要的读者可以去我的github下载源码：
ScaffoldPage.dart