Flutter基础类、错误态、加载态、无数据态等封装

  Flutter中页面没有像Android、IOS 定义那么明确,Android中就是 Activity,IOS 中就是 UIViewController。

  在Flutter中,几乎所有东西都是Widget。

将Widget视为可视组件(或与应用程序的可视方面交互的组件)。

  在项目开发中基本都会有一个 BaseActivity/BaseVIewController,封装一些基本操作及公共部分,参照Android/IOS中 BaseActivity/BaseVIewController实现,在 Flutter也实现同样功能的 抽象的BaseWidget。

实现功能

  1. 开发页面时,写一个类继承 BaseWidget,就会提示必须要实现的抽象方法,俗称模板模式,要做的事情一目了然。这里将要写的代码定义成一个 Live Templates。
  2. 导航栏AppBar可以轻松隐藏和设置背景颜色(图片),其中包含导航栏中的左边返回键、中间的标题、右面的按钮或文本,可以随意设置隐藏和现实,当然可以重写他们的方法,随意设置自己的Widget,实现高度定制。
  3. 内置了一个错误页面 ,主要用于网络加载出错或服务器返回错误的时候 ,可以直接调方法就显示,不用每个页面都写错误页面,避免需求变更时束手无策。
  4. 内置一个无数据页面,用于列表无数据时展示。使用方法和功能和错误页面差不多。
  5. 内置一个loading加载页面,主要用于进入页面时显示一个 loading 视图,默认进入界面就显示,数据加载完成,显示正常内容视图,加载失败话,就显示上面定义的错误视图。
  6. 进入自动调用 queryData 进行网络请求。
  7. 内置了安全键盘,在要使用安全键盘页面,初始化一下就可以了。
  8. 。。。
  9. 有了基类,以后拓展就很方面(如:返回刷新等)。

实现思路

  BaseWidget 是一个有状态的基础 Widget,由两部分组成。

  • Widget 定义
abstract class BaseWidget extends StatefulWidget {
  @override
  BaseWidgetState createState() => getState();

  ///子类实现
  BaseWidgetState getState();
}

此部分在Widget的生命周期内不会发生变化,但可以接受可由其相应的State实例使用的参数,当需要将其添加到窗口上时,可以通过实例化来实现。

  • Widget State 定义
abstract class BaseWidgetState<T extends BaseWidget> extends State<T> {
@override
void initState() {
  super.initState();
}


@override
Widget build(BuildContext context) {
  ...
  }

}

此部分是在Widget的生命周期中变化的部分,并强制每次应用修改时重建Widget的这个特定实例。
此两部分别被子类继承,并要求实现其抽象方法,getState 用于创建继承BaseWidgetState的子类 Widget State实例。

布局搭建

在 BaseWidgetState 中内置了标题栏、错误视图、空页面视图、加载中视图、安全键盘等几个基本控件,预留一个抽象方法buildWidget给子类搭建自己的布局。

@override
Widget build(BuildContext context) {
  return _hasSecurityKeyboard
      ? _buildWidgetWithKeyboard()
      : _buildWidgetDefault();
}

///构建默认视图
Widget _buildWidgetDefault() {
  ///使用appbar,也可直接只有 body 在 body 里自定义状态栏、标题栏
  return WillPopScope(
    child: Scaffold(
      appBar: _buildAppBar(),
      body: _buildBody(),
    ),
    onWillPop: _requestPop,
  );
}

///构建包含安全键盘视图
Widget _buildWidgetWithKeyboard() {
  ///WidgetsApp或者MaterialApp,Flutter会自动默认创建一个Navigator
  ///用于键盘弹出的时候页面可以滚动到输入框的位置
  return WillPopScope(
    child: KeyboardMediaQuery(
      child: Builder(builder: (ctx) {
        ///初始化键盘监听并且传递当前页面的context
        KeyboardManager.init(ctx);
        return Scaffold(
          appBar: _buildAppBar(),
          body: _buildBody(),
        );
      }),
    ),
    onWillPop: _requestPop,
  );
}

///物理返回
Future<bool> _requestPop() {
  bool b = true;
  if (KeyboardManager.isShowKeyboard) {
    KeyboardManager.hideKeyboard();
    b = false;
  }
  return Future.value(b);
}

///子类实现,构建各自页面UI控件 相当于setContentView()
Widget buildWidget(BuildContext context);

///构建内容区
Widget _buildBody() {
  return Container(
    ///内容区背景颜色
    color: LcfarmColor.colorF8F9F8,
    child: Stack(
      children: <Widget>[
        Offstage(
          offstage: !_isContentWidgetShow,
          child: buildWidget(context),
        ),
        _buildErrorWidget(),
        _buildEmptyWidget(),
        _buildLoadingWidget(),
      ],
    ),
  );
}

  • 通过 _hasSecurityKeyboard控制是否内置安全键盘,子类可以在 initState中通过初始化该字段来实现。
  • 同样错误视图、空白视图、加载中视图提供方法让子类控制是否显示,以及设置相应的文字、图片等。

使用方法

  • 基本实现代码如下:
class Test extends BaseWidget {
  @override
  BaseWidgetState getState() {
    return _TestState();
  }
}

class _TestState extends BaseWidgetState<Test> {
  @override
  Widget buildWidget(BuildContext context) {
    return Container();
  }
  
  @override
  void queryData() {
   
  }
}

  • getState 返回继承BaseWidgetState的 Widget State。
  • buildWidget 用于构建当前视图
  • queryData用于是否进入查询数据

如有查询,则直接调用网络请求即可。

@override
void queryData() {
  _loadData(...)
}

如无需查询数据,则禁用掉即可。

@override
void queryData() {
  ///进入无需网络请求数据
  disabledLoading();
}
  • 显示成功视图、错误视图、空白视图
void _loadData(LoadType type) {
  AccountService.letterList(
    pageNo,
    (Pager<LetterModel> pager) {
      ///暂无数据
      if (pager.total == 0) {
        showLoadEmpty();
        return;
      }
      pageNo = pager.currentPage;
      if (type == LoadType.loadMore) {
        letterModels.addAll(pager.list);
      } else {
        letterModels = pager.list;
      }

      showLoadSuccess();
    },
    (HttpError error) {
      showLoadFailure(error.code, error.message);
    },
  );
}

最后

  如果在使用过程遇到问题,欢迎下方留言交流。

学习资料

请大家不吝点赞!因为您的点赞是对我最大的鼓励,谢谢!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,524评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,869评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,813评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,210评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,085评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,117评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,533评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,219评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,487评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,582评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,362评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,218评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,589评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,899评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,176评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,503评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,707评论 2 335

推荐阅读更多精彩内容

  • Flutter是谷歌的移动UI框架,可以快速在iOS和Android上构建高质量的原生用户界面。 Flutter可...
    Cat9527阅读 662评论 0 1
  • 昨天下午,我们一家三口相约出去吃海鲜大餐。我和妈妈到了酒店,但是爸爸没到,我们等啊等终于爸爸出现了,可是己经过了一...
    西安臭蛋的爸爸阅读 316评论 1 0
  • 今天早上六点半起来就回来上班了,我走时妈妈又睡觉了,后来打电话给哥哥,哥哥说我走了,他就去了,妈妈醒了,喝了一碗奶...
    心境如花阅读 111评论 0 0
  • 说起情诗来,你想到的可能是《上邪》里“上邪!我欲与君相知,长命无绝衰。山无陵,江水为竭,冬雷震震,夏雨雪,天地合,...
    醉懂阅读 321评论 0 1
  • 曾经在网上看到一段话:父母是我们和死神之间的一道屏障,父母在,人生尚有来处;父母去,人生只剩归途。...
    人生有味是清欢丶阅读 111评论 0 1