Flutter入門進階之旅（十六）Scaffold 腳手架

謝棟發表於2019-05-17

在本欄的前面章節的學習中，我們基本上把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

  /// An app bar to display at the top of the scaffold.
  final PreferredSizeWidget appBar;
複製程式碼

通常我們會給根據不同的業務場景設定不同的AppBar，關於AppBar的構造方法大部分屬性讀者都可以根據屬性名自解釋，我就不貼出來贅述了，下面我舉幾個常用的例子

1.1 設定Title

  appBar: AppBar(
          title: Text("Scaffold 腳手架"),
         ),
複製程式碼

標題居中：

  appBar: AppBar(
          title: Text("Scaffold 腳手架"),
          centerTitle: true,
         ),
複製程式碼

1.2設定左上角返回按鈕

從上面的程式碼以及圖片中我們看到Scaffold中預設為我們在appBar上指定了一個返回的箭頭，點選箭頭返回上一頁，當然我們可以通過leading屬性自定義左上角的圖示，但是當我們指定了leading點選事件就需要我們自己單獨處理了，也就是說，指定了leading之後，我們就沒辦法在點選箭頭的時候結束當前頁，但是我們可以自己實現這一操作。

 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以三個小點的形式放進摺疊選單裡，下面我們結合原始碼看下效果圖，讀者一看便知。

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來完成這一效果。

    bottom: TabBar(
            controller: _tabController,
            tabs: topTabLists
                .map((element) => Tab(
                      text: element,
                    ))
                .toList(),
//            onTap: (index) => {},
          )),
複製程式碼

使用TabBar必須傳入controller屬性，我們通過initState()方法初始化_tabController

  @override
  void initState() {
    super.initState();
    //初始化頂部TabController
    _tabController = TabController(length: topTabLists.length, vsync: this);
  }
複製程式碼

Tab屬性設定icon圖示+文字

 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，可現實在螢幕中央，這裡我就不過多贅述了。

  body: Container(
        child: Text("內容區域"),
      ),
複製程式碼

3.抽屜選單

在文章開題的時候，我提到了抽屜選單可以通過drawer、endDrawer指定左右兩側開啟的抽屜選單。下面我們就來看下效果。

左側抽屜

drawer: MyDrawer(), //MyDrawer詳細程式碼在下面
複製程式碼

右側抽屜

endDrawer: MyDrawer(), //MyDrawer詳細程式碼在下面
複製程式碼

上述抽屜相關的MyDrawer程式碼如下

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章節中我們講解過，知識點也比較簡單，就是在頁面佈局快速構建出一個懸浮按鈕。

floatingActionButton: FloatingActionButton(
        onPressed: (){
          print("---------");
        },
        child: Icon(Icons.add),
      ),
複製程式碼

我們可以通過在Scaffold腳手架中指定floatingActionButtonLocation來指定floatingActionButton顯示的位置。

各個位置屬性基本見名知意，我就不逐個寫效果圖展示了，下面只貼上一個懸停在底部導航欄上的樣式。

 floatingActionButtonLocation:
          FloatingActionButtonLocation.centerDocked, //設定FloatingActionButton的位置
    );
複製程式碼

5.底部導航欄 bottomNavigationBar

bottomNavigationBar的使用場景還比較多，一般我們的多頁面app都會通過底部的Tab來切換App首頁展示的不同內容，在Flutter的Scaffold中為我們提供了快捷用於構建底部Tab的方法，我們通過給BottomNavigationBar的Items屬性設定需要展示的BottomNavigationBarItem陣列即可。

 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為三個的時候可以正常顯示，但是多於三個就變成白色了，不能正常顯示。

這裡我從原始碼角度上給讀者解讀一下。

  /// 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完成，文字描述可能雲裡霧裡的。

一圖勝千言

//與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也實現了類似的效果，但是前者是直接壓在導航欄上面的，而後者是嵌入進去的，效果更逼真。讀者可對比下方的效果圖。

限於篇幅問題，本篇博文的完整程式碼我就不在此貼出來了，有需要的讀者可以去我的github下載原始碼： ScaffoldPage.dart

Flutter入門進階之旅（十三）Flutter 路由
2019-04-15
Flutter路由
Flutter入門進階之旅（三）Text Widgets
2019-04-15
Flutter
Flutter入門進階之旅（二十）Flutter外掛開發
2020-01-20
Flutter
Flutter入門進階之旅（十二）Flutter 資料儲存
2019-04-15
Flutter
Flutter入門進階之旅（二十二）Flutter自定義view
2021-09-02
FlutterView
Flutter入門進階之旅（十四）ListView&GridView
2019-04-15
FlutterView
Flutter入門進階之旅（十）Dialog&Toast
2019-04-15
FlutterAST
Flutter入門進階之旅（十九）Flutter與原生平臺互動
2020-01-02
Flutter
React入門---react腳手架
2018-03-09
React
Flutter從入門到踏進半隻腳
2020-03-02
Flutter
Flutter入門進階之旅（十五）ListView下拉重新整理&上拉載入更多
2019-04-15
FlutterView
Next.js 腳手架進階 —— Zeit Now部署
2019-04-12
JS
Next.js腳手架進階 —— 部署上線
2019-01-24
JS
Flutter入門進階之旅（十八）Flutter專案打包成aar整合到原生Android專案
2019-10-31
FlutterAndroid
Python 爬蟲從入門到進階之路（十六）
2019-07-11
Python爬蟲
Next.js腳手架進階 — 完美契合ant-design
2018-12-05
JS
vue腳手架
2024-06-07
Vue
Next.js腳手架進階 — 封裝fetch && 增加中介軟體
2018-12-10
JS封裝
vue - Vue腳手架
2022-05-05
Vue
vue腳手架工具
2018-07-20
Vue
Android入門（十六）：手機多媒體
2018-09-21
Android
elk 入門到進階
2018-08-13
SQL入門-進階教程
2020-09-27
SQL
Flutter 入門與實戰（三十六）：Dio 篇章總結
2021-07-26
Flutter
vue腳手架基礎
2020-11-21
Vue
plop小型腳手架工具
2020-11-23
Flutter 容器控制元件篇-->Scaffold
2019-09-30
Flutter控制元件
Flutter深入淺出元件篇---Scaffold
2021-08-22
Flutter元件
分散式架構 -- 學習路線圖（入門到進階）
2018-04-23
分散式架構
Redis入門--進階詳解
2020-08-26
Redis
Redis從入門到進階
2019-04-18
Redis
Flutter入門與實戰（一）：我的第一個 Flutter 應用之旅
2021-05-15
Flutter
《大前端進階 Node.js》系列 P6必備腳手架/CI構建能力（上）
2020-03-25
前端Node.js
《大前端進階 Node.js》系列 P6必備腳手架/CI構建能力（下）
2020-04-01
前端Node.js
Flutter 入門與實戰（六十六）：聽說 MobX 很流行，進來了解一下？
2021-08-29
Flutter
走進Vue-cli原始碼，自己動手搭建前端腳手架工具
2018-04-02
Vue原始碼前端
搭建webpack簡易腳手架
2019-01-26
Web
vue - Vue腳手架/TodoList案例
2022-05-06
Vue