flutter實戰6：TAB頁面切換免重繪

燃燒的魚丸發表於2018-10-03
Flutter

大家好，經過幾個月的潛水，Flutter出乎意料的火熱，抱歉一直沒有更新，由於加入了創業團隊，經歷了幾波大起大落，現在終於騰出時間搞搞技術，現在和成都的幾位技術極客合作推出門路網，正在用flutter實踐開發APP，也算是對flutter商業化的小試牛刀，本篇將門路網APP用到的flutter技術進行簡單分享。

之前的新聞APP的實踐專案中，用到了Tab+TabBarView+Tabcontroller的用法，實現了基於scaffold下頂部標籤頁的頁面切換，但是大家都會遇到來回切換頁面導致TabBarView自動重繪的問題，頁面無法停留到切換前的狀態，這個問題也是困擾了我很久，用PageStorageKey搭配Stack+Offstage解決這個問題。

首先，我們自己寫一個TabBar玩玩，為什麼呢？因為這樣可以實現控制元件的高度自定義，順便學一學新的元件用法：

class NewsTab {
  String text;
  String tab;
  NewsTab(this.text,this.tab);
}
//定義tab頁基本資料結構
final List<NewsTab> NewsTabs = <NewsTab>[
  new NewsTab('金融','financial'),
  new NewsTab('科技','technology'),
  new NewsTab('醫療','medical'),
];

class TabNavigation extends StatelessWidget {
  TabNavigation({this.currentTab, this.onSelectTab});
  final NewsTab currentTab;
  final ValueChanged<NewsTab> onSelectTab;  //這個引數比較關鍵，仔細理解下，省了setState()呼叫的環節

  @override
  Widget build(BuildContext context) {
    return Row(
      children: NewsTabs.map((item){
        return GestureDetector(    //手勢監聽控制元件，用於監聽各種手勢
          child: Container(
            padding: EdgeInsets.fromLTRB(24.0, 0.0, 24.0, 0.0),
            child: Text(item.text,style: TextStyle(color: _colorTabMatching(item: item)),), 
          ),
          onTap: ()=>onSelectTab(item,)  
          //onSelectTab函式的使用非常巧妙，
          //相當於定義了一個介面，可操控當前控制元件以外的資料
        );
      }).toList()       
    );
  }

  //定義tab被選中和沒被選中的顏色樣式
  Color _colorTabMatching({NewsTab item}) {
    return currentTab == item ? Colors.black : Colors.grey;
  }
}
複製程式碼

為什麼要這麼做呢？因為我們可以通過onSelectTab函式對外部資料進行控制，主頁面呼叫TabNavigation：

class _MainListState extends State<MainList> {
    NewsTab _currenttab = NewsTabs[0];    //定義預設開啟的Tab頁

    void _selectTab(NewsTab tab){    //修改狀態值
        setState(() {
          _currenttab = tab;
        });
      }

    TabNavigation(
        currentTab: _currenttab,
        onSelectTab: _selectTab,
        ),
    ....
}
複製程式碼

當使用TabNavigation時，向其傳入定義好的_selectTab函式，即可完成狀態值修改的任務，這也是子控制元件向父控制元件傳遞引數的一種方式，特別適用於子控制元件修改父控制元件狀態值時的場景。

以上是Tab標籤和主頁面的定義，接下來看Tab頁的定義：

class NewsList extends StatefulWidget{
  @override
  NewsList({this.newsType,this.pageKey});

  final PageStorageKey<NewsTab> pageKey; //當前控制元件唯一標識Key
  final String newsType; 

  NewsListState createState() => new NewsListState();
}

class NewsListState extends State<NewsList>{
    ....
}
複製程式碼

注意看控制元件唯一標識Key的定義，有關PageStorageKey的說明請參考官方閱讀理解，看不懂可以用谷歌翻譯過一遍，這裡不做贅述了，關鍵在PageStorageKey<NewsTab>中的<NewsTab>。PageStorageKey是區域性Key，在父控制元件中定義時不要重複即可，所以我用了NewsTab型別，當然小夥伴也可以定義其他不會重複的值作為標識，不過可能會比我這個麻煩一點，想知道為啥，因為在主頁面下是這樣定義和使用Key的：

class MainList extends StatefulWidget {
  const MainList({ Key key }) : super(key: key); 
  @override
  _MainListState createState() => new _MainListState();
}

class _MainListState extends State<MainList> {
  //定義Key值，型別名即是建構函式，需要傳入匹配型別的引數
  Map<NewsTab, PageStorageKey<NewsTab>> pageKeys = {
    NewsTabs[0]: PageStorageKey<NewsTab>(NewsTabs[0]),
    NewsTabs[1]: PageStorageKey<NewsTab>(NewsTabs[1]),
    NewsTabs[2]: PageStorageKey<NewsTab>(NewsTabs[2]),
  };
  ...
  Widget build(BuildContext context){
      return Scaffold(
          ...
          body: Stack(      //Stack在初始化時，會將子控制元件全部渲染，而TabBarView則僅渲染預設子控制元件
            children:  NewsTabs.map((item) {
              return Offstage(      //使用Offstage，把不需要顯示的子控制元件隱藏起來
                offstage: _currenttab != item,
                child: NewsList(
                  pageKey: pageKeys[item],    //傳入Key值
                  newsType: item.tab),
            );
          }).toList(),
          )
      }
    }
  }
複製程式碼

這裡用到了Stack+Offstage的組合，特性在註釋中可瞭解，由於這兩個控制元件可以保留子控制元件的特性，再加上PageStorageKey<NewsTab>標識，即可以保證NewsList在控制元件樹中的位置保持不變，從而避免了NewsList被切換後重復渲染的問題。

為了方便理解，我把pageKeys的定義和使用分開進行，也就是在列表控制元件NewsList初始化的時候，即為其分配了一個PageStorageKey<NewsTab>型別的key值，保證它需要重複使用的時候不被flutter認為是新控制元件，也就不會觸發重繪了。當然你也可以這麼寫：

NewsList(
   pageKey: PageStorageKey<NewsTab>(item),
   newsType: item.tab),
  )
複製程式碼

以上兩種方式，不管怎麼寫，都會通過遍歷NewsTabs獲取NewsTab，這樣建立PageStorageKey方便不少。

為什麼沒有用GlobalKey?因為用不上，一方面GlobalKey比較耗費資源，存在於APP的整個生命週期，如同全域性變數，另一方全域性不允許重複定義，萬一在別的地方需要重建相同控制元件，還得費腦子想辦法避開相同的GlobalKey，免得捅出其他簍子。另外補充一點，只有有狀態控制元件才能使用GlobalKey，一看GlobalKey的定義你就明白了：GlobalKey<State<StatefulWidget>>，是給StatefulWidget下的State類使用的。

動圖對比一下Tab+TabBarView+Tabcontroller和PageStorageKey+Stack+Offstage：

Tab+TabBarView+Tabcontroller組合效果

PageStorageKey+Stack+Offstage組合效果

可以看到，在頁面初始渲染和切換時，兩者的區別，前者初始化時僅渲染了一個Tab頁，頁面切換時每個Tab頁都會自動dispose掉，並且新頁面要重新initState，而後者則在初始化時即渲染了所有子Tab頁，頁面切換時沒有dispose，而是僅呼叫了有狀態控制元件的didChangeDependencies事件。

原始碼地址請點選此處，本次分享僅做解決方案上的思考，也許還有更好的方案，歡迎大家分享。

此處感謝JarvanMo的分享才有了以上的解決方案

另外再總結幾個小問題

1.當專案打包APK後，再次修改程式碼執行，有一定機率遇到新程式碼不生效 解決辦法： 1). 開啟flutter下的這個目錄：[你的地址]\flutter\bin 2). 刪除cache資料夾 3). 命令列中輸入：flutter doctor 4). 等待處理結束後，再次flutter run

我以為直接用命令：flutter clean刪除專案目錄下的build資料夾，重新執行一下就可以解決問題，沒想到執行後報錯：

缺少build資料夾報錯
flutter clean會直接刪除整個build資料夾，都不帶放回收站的，然後就悲劇了，整個專案沒法執行，這時候你需要一句命令滿血復活：

flutter create -i objc。

  • -i 是表示iOS專案開發語言，objc和swift兩個選項，其中objc是預設的。
  • -a 是表示Android專案開發語言，java和kotlin兩個選項，其中java是預設的 此處感謝JarvanMo的分享

2.使用Navigator做頁面跳轉時，記得在其使用它的父控制元件建構函式或函式中新增BuildContext屬性

缺少BuildContext引數報錯

BuildContext屬性在flutter中的意義是控制元件在控制元件樹中的錨點，也可以理解為索引，當需要跳轉頁面時，需要告訴Navigator當前控制元件的錨點，以便於在新頁面中點選返回鍵時，可以回退到原來的頁面，英文好的同學可以檢視原閱讀理解。實際上Navigator也是基於此錨點建立頁面錨點堆疊，所以當你需要對一個寫的很深的子控制元件觸發頁面跳轉時，需要把context引數從頂層父控制元件一層一層往下傳。 控制元件函式中加入BuildContext context引數的意義是讓控制元件明白：我是誰，我從哪裡來，要到哪裡去，比如：

//這裡加入了BuildContext context，是為了把獲取到的context傳遞到子控制元件，以用於Navigator做頁面跳轉
_list(BuildContext context, List dataList){
         ....
        return ListView.builder(
          // padding: const EdgeInsets.all(16.0),
          itemCount: dataList.length,
          itemBuilder: (context, i) {
              //context引數相當於當前控制元件在控制元件樹中的錨點，
              //缺少這個引數會導致列表中的專案無法通過MaterialPageRoute進入下一個頁面
              return _newsRow(dataList[i],context);
            }
          );
    }

//這裡又需要定義context，是從上面的_list傳下來的
_newsRow(Map newsInfo,BuildContext context){
    return ListTile(
        ...
        onTap: (){
        Navigator.of(context).push(        //直到被Navigator.of(context)用到
          MaterialPageRoute(
            builder: (BuildContext context) => NewsDetail(        
              id:newsInfo["id"].toString()
              )
            )
          );
      },
  );
}
複製程式碼

那麼控制元件樹是啥呢？相信大家在寫頁面佈局的時候應該感受到了什麼叫父子控制元件，整個flutter專案就是N個父子控制元件串起來的控制元件樹。

3. 從網路獲取的json資料內包含陣列，無法直接被List.add()或List.addAll() 這個問題需要處理兩個問題：

  • 用於儲存資料的List物件，必須要進行初始化，否則直接呼叫list.add()會報null錯誤：

List list = new List();

  • 獲取到的json資料鍵值對有資料的情況下，無法直接賦值到定義好的List<Map> list，需要重新組裝資料，由於獲取到的json鍵值對中有這樣格式的資料：

      //獲取到的json資料
  data:{items:[{'k1':'v1'},{'k2':'v2'},{'k3':'v3'},{'k4':'v4'},...]}
複製程式碼

我便直接賦值給了上面定義的list變數：

    List<Map> list = new List();
    list = request['data']['items'];
複製程式碼

結果就悲劇了，一直報這個錯：

型別匹配錯誤

所以，從網路請求獲取到的json資料預設是Iterable<Map<dynamic,dynamic>>格式，無法直接賦值給List物件，因此需要做一下處理：

    List<Map> a = new List();   //這句new很重要，陣列物件例項化，否則無法執行a.add()
        if (request['success']==true){    
          for(int i=0;i<request['data']['items'].length;i++){
            a.add(request['data']['items'][i]);    //
          }
          return a;   //此處的意義便是把網路請求獲取到的資料標準化，否則無法直接賦值給dataList
        }else return null;
複製程式碼

這樣就好多了，當然，如果你做了json序列化，請無視這個問題。

篇幅較長見諒，在此感謝大家的支援，想繼續瞭解更多Flutter技巧，請關注Flutter圈子，歡迎大牛向這裡投稿佈道，也可以加入flutter 中文社群（官方QQ群：338252156）共同成長，謝謝大家~

相關文章