Flutter 入门指北(Part 3)之 Appbar，Scaffold 填坑

刺骨的言语ヽ痛彻心扉 2022-01-19 05:43 291阅读 0赞

**该文已授权公众号 「码个蛋」，转载请指明出处**

上一篇讲完 `Flutter` 中的一些基本部件，这篇就先填完上篇留下的没写的 `AppBar` 的坑，以及 `Scaffold` 其他参数的使用，在开始前，先补一张缩略版的脑图

完整版放在网盘，小伙伴自己下载。 [完整版脑图][Link 1]，提取码：el9q，[xmind 文件][xmind] 提取码：1o5d

\#\#\#\#AppBar（part2）

这一部分，我们只关注 `Scaffold` 中的 `AppBar` 剩下的还是埋坑【坑4】(/内牛满面，居然已经埋了那么多坑了，坑虽多，代码还是要继续的)，因为稍后会用到 `StatefulWidget` 的属性，所以就直接先使用了，和 `StatelessWidget` 区别用法可以这么记 **需要数据更新的界面用 `StatefulWidget`**，当然也不是绝对的，就是之前留的【坑1】所说的状态管理

class HomePage extends StatefulWidget {
      @override
      _HomePageState createState() => _HomePageState();
    }
    
    class _HomePageState extends State<HomePage> {
      List<String> _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: <Widget>[
              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<T> = List<PopupMenuEntry<T>> Function(BuildContext context);
    // onSelected
    typedef PopupMenuItemSelected<T> = void Function(T value);
    
    const PopupMenuButton({
        Key key,
        @required this.itemBuilder, // 用于定义 menu 列表，需要传入 List<PopupMenuEntry<T>>
        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<HomePage> with SingleTickerProviderStateMixin {
      List<String> _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: <Widget>[
              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<HomePage> with SingleTickerProviderStateMixin {
      List<String> _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: <Widget>[
              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: <Widget>[
              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: <Widget>[
                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<CheckSwitchDemoPage> {
      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: <Widget>[
            Row(
              children: <Widget>[
                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: <Widget>[
                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 个大坑，那就等以后继续解决吧~

最后代码的地址还是要的：

1.  文章中涉及的代码：[demos][]
2.  基于郭神 `cool weather` 接口的一个项目，实现 `BLoC` 模式，实现状态管理：[flutter\_weather][flutter_weather]
3.  一个课程(当时买了想看下代码规范的，代码更新会比较慢，虽然是跟着课上的一些写代码，但是还是做了自己的修改，很多地方看着不舒服，然后就改成自己的实现方式了)：[flutter\_shop][flutter_shop]

如果对你有帮助的话，记得给个 **Star**，先谢过，你的认可就是支持我继续写下去的动力~

转载于:https://juejin.im/post/5cb33f82f265da038364b762

[Link 1]: https://link.juejin.im?target=https%3A%2F%2Fpan.baidu.com%2Fs%2F1KIYWMMcu1okvQxD2vWAwKw
[xmind]: https://link.juejin.im?target=https%3A%2F%2Fpan.baidu.com%2Fs%2F1DMg0cyjUoHQaXkJzJyYFyw
[demos]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fkukyxs%2Fflutter_arts_demos_app
[flutter_weather]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fkukyxs%2Fflutter_weather
[flutter_shop]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fkukyxs%2Fflutter_shop