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 NewsTabs = [
  new NewsTab('金融','financial'),
  new NewsTab('科技','technology'),
  new NewsTab('医疗','medical'),
];

class TabNavigation extends StatelessWidget {
  TabNavigation({this.currentTab, this.onSelectTab});
  final NewsTab currentTab;
  final ValueChanged 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 {
    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 pageKey; //当前控件唯一标识Key
  final String newsType; 

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

class NewsListState extends State{
    ....
}

注意看控件唯一标识Key的定义,有关PageStorageKey的说明请参考官方阅读理解,看不懂可以用谷歌翻译过一遍,这里不做赘述了,关键在PageStorageKey中的PageStorageKey是局部Key,在父控件中定义时不要重复即可,所以我用了NewsTab类型,当然小伙伴也可以定义其他不会重复的值作为标识,不过可能会比我这个麻烦一点,想知道为啥,因为在主页面下是这样定义和使用Key的:

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

class _MainListState extends State {
  //定义Key值,类型名即是构造函数,需要传入匹配类型的参数
  Map> pageKeys = {
    NewsTabs[0]: PageStorageKey(NewsTabs[0]),
    NewsTabs[1]: PageStorageKey(NewsTabs[1]),
    NewsTabs[2]: PageStorageKey(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标识,即可以保证NewsList在控件树中的位置保持不变,从而避免了NewsList被切换后重复渲染的问题。

为了方便理解,我把pageKeys的定义和使用分开进行,也就是在列表控件NewsList初始化的时候,即为其分配了一个PageStorageKey类型的key值,保证它需要重复使用的时候不被flutter认为是新控件,也就不会触发重绘了。当然你也可以这么写:

NewsList(
   pageKey: PageStorageKey(item),
   newsType: item.tab),
  )

以上两种方式,不管怎么写,都会通过遍历NewsTabs获取NewsTab,这样创建PageStorageKey方便不少。

为什么没有用GlobalKey?因为用不上,一方面GlobalKey比较耗费资源,存在于APP的整个生命周期,如同全局变量,另一方全局不允许重复定义,万一在别的地方需要重建相同控件,还得费脑子想办法避开相同的GlobalKey,免得捅出其他篓子。另外补充一点,只有有状态控件才能使用GlobalKey,一看GlobalKey的定义你就明白了:GlobalKey>,是给StatefulWidget下的State类使用的。

动图对比一下Tab+TabBarView+TabcontrollerPageStorageKey+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实战6:TAB页面切换免重绘_第1张图片
flutter clean会直接删除整个build文件夹,都不带放回收站的,然后就悲剧了,整个项目没法运行,这时候你需要一句命令满血复活:

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

此处感谢JarvanMo分享

2.使用Navigator做页面跳转时,记得在其使用它的父控件构造函数或函数中添加BuildContext属性

flutter实战6:TAB页面切换免重绘_第2张图片

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 list,需要重新组装数据,由于获取到的json键值对中有这样格式的数据:

    //获取到的json数据
    data:{items:[{'k1':'v1'},{'k2':'v2'},{'k3':'v3'},{'k4':'v4'},...]}

我便直接赋值给了上面定义的list变量:

    List list = new List();
    list = request['data']['items'];

结果就悲剧了,一直报这个错:
flutter实战6:TAB页面切换免重绘_第3张图片

所以,从网络请求获取到的json数据默认是Iterable>格式,无法直接赋值给List对象,因此需要做一下处理:

    List a = new List();   //这句new很重要,数组对象实例化,否则无法运行a.add()
        if (request['success']==true){    
          for(int i=0;i

这样就好多了,当然,如果你做了json序列化,请无视这个问题。

篇幅较长见谅,在此感谢大家的支持,想继续了解更多Flutter技巧,请关注Flutter圈子,欢迎大牛向这里投稿布道,也可以加入flutter 中文社区(官方QQ群:338252156)共同成长,谢谢大家~

你可能感兴趣的:(flutter,dart,dartlang)