用 FutureBuilder 提高开发效率
常见场景
- 展示请求按钮
- 用户点击按钮,显示loading
- 展示数据或者错误

抽象模式
- 展示请求按钮(
初始状态
) - 用户点击按钮,显示loading(
请求中状态
) - 展示数据或者错误 (
结束状态(成功或失败)
)
转换成程序语言
以上三种现实情况对应 AsyncSnapshot
三个状态
ConnectionState.none
初始态ConnectionState.waiting
请求态ConnectionState.done
完成态snapshot.hasError
完成(异常)snapshot.hasData
完成(正常)
使用 FutureBuilder 处理这个场景
这篇文章的主角,FutureBuilder
就是为了解决这个问题存在的。它接收一个 Future
请求,和对应以上几种情况的 widget
回调。即可把数据和界面串联起来,避免额外声明仅用来传递数据用的变量。
提前声明了一个 _showResult
变量,以表示页面是否触发请求。
并且封装了一个 _fetch()
网络请求。
Future<Map> _fetch() async {
return (await Dio().get("https://jsonplaceholder.typicode.com/users/1"))
.data;
}
请求的结果是任意的,不管是封装好的对象,map
,list
,都可以,只要是一个 Future<T>
把这个 Future
调用安放到 FutureBuilder
的 future
参数上, 并用 _showResult
来控制何时来触发这个请求。
FutureBuilder(
future: _showResult ? _fetch() : null,
...
)
再把每一个 Future
的结果对应的 widget
设置到 builder
参数上:
FutureBuilder(
...
builder: (context, snapshot) {
switch (snapshot.connectionState) {
case ConnectionState.none: // -------- 初始态
return RaisedButton(
onPressed: () {
setState(() {
_showResult = true; // 点击按钮,触发请求
});
},
child: Text("start"),
);
case ConnectionState.waiting: // -------- 请求态
return CircularProgressIndicator();
case ConnectionState.done: // -------- 完成态
if (snapshot.hasError) { // 异常
return Text(
'${snapshot.error}',
style: TextStyle(color: Colors.red),
);
} else { // 正常
return Text(snapshot.data["name"]);
}
break;
default:
break;
}
return Container();
},
),
总结
FutureBuilder
把数据请求的 Future<T>
中的数据 T
通过 Builder
的 ConnectionState
衍生出所有可能性,并在每个可能性里 return
一个 Widgets
。最终实现了 state -> UI 的目的
转载自:https://juejin.cn/post/6844903878563987463