flutter实战6：TAB页面切换免重绘

大家好，经过几个月的潜水，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页，页面切换时每个Tab页都会自动dispose掉，并且新页面要重新initState，而后者则在初始化时即渲染了所有子Tab页，页面切换时没有dispose，而是仅调用了有状态控件的didChangeDependencies事件。

源码地址请点击此处，本次分享仅做解决方案上的思考，也许还有更好的方案，欢迎大家分享。

此处感谢JarvanMo的分享才有了以上的解决方案

另外再总结几个小问题

1.当项目打包APK后，再次修改代码运行，有一定几率遇到新代码不生效
解决办法：
1). 打开flutter下的这个目录：[你的地址]flutterbin
2). 删除cache文件夹
3). 命令行中输入：flutter doctor
4). 等待处理结束后，再次flutter run

我以为直接用命令：flutter clean删除项目目录下的build文件夹，重新运行一下就可以解决问题，没想到运行后报错：

flutter clean会直接删除整个build文件夹，都不带放回收站的，然后就悲剧了，整个项目没法运行，这时候你需要一句命令满血复活：

flutter create -i objc。

• -i 是表示iOS项目开发语言，objc和swift两个选项，其中objc是默认的。
• -a 是表示Android项目开发语言，java和kotlin两个选项，其中java是默认的

此处感谢JarvanMo的分享

2.使用Navigator做页面跳转时，记得在其使用它的父控件构造函数或函数中添加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<Map> 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）共同成长，谢谢大家~