前言
我们在《很流行的状态管理库 MobX 是怎么回事?》介绍了 MobX 的基本概念和简单的计数器示例。本篇我们引入一个非常酷炫的图表插件库来讲解 MobX 网络请求后渲染曲线。
MobX 驱动 UI
MobX 驱动 UI 时非常简单,使用 flutter_mobx 插件后,简化到只需要使用 Observer
的 builder
属性包裹依赖状态数据的子组件即可。只要子组件中有依赖状态数据,在状态发生改变后就会自动刷新。可以说,MobX 大大简化了状态管理的使用,使得我们可以专注于业务代码,而无需关心状态和 UI 界面之间的联系。
Observer(
builder: (_) => Text(
'${_counter.value}',
style: const TextStyle(fontSize: 20),
),
),
复制代码
因此,MobX 本身太简洁了(👍🏻)!并没有什么太多可以介绍的,但是如果说要实现更复杂的状态管理的话,还需要有别的方式,这个留在我们下一篇来介绍。
图表插件库 fl_chart
pub 上提供了不少图标插件库,其中 fl_chart 是最为流行的之一,我们来看看官方的示例,在手机上能够实现这样的效果已经十分酷炫了!示例工程中提供了所有已经支持的图表的示例,我们只需要按照示例进行修改就可以绘制我们自己的图表。
UI 构建
我们以曲线图为例,通过后端数据绘制一条曲线。先来构建曲线 UI。
class LineChartDemo extends StatelessWidget {
LineChartDemo({Key? key}) : super(key: key);
final ChartStore store = ChartStore();
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('曲线')),
body: Observer(
builder: (context) => LineChart(
sampleData1(store.lineYData),
swapAnimationDuration: const Duration(milliseconds: 250),
),
),
floatingActionButton: FloatingActionButton(
onPressed: () {
store.featchLineData();
},
child: Icon(Icons.refresh, color: Colors.white),
),
);
}
//...
}
复制代码
曲线绘制的关键代码是以状态数据lineYData
(Y 轴数据)作为曲线的源数据,从而使得状态数据更新后可以自动渲染曲线。下面简要介绍一下曲线图的组成:
LineChartData sampleData1(List<double> yData) => LineChartData(
lineTouchData: lineTouchData1,
gridData: gridData,
titlesData: titlesData1,
borderData: borderData,
lineBarsData: lineBarsData1(yData),
minX: 0,
maxX: 15,
maxY: yData
.reduce((value, element) => value < element ? element : value)
.toDouble() +
1.0,
minY: yData
.reduce((value, element) => value > element ? element : value)
.toDouble() -
1.0,
);
复制代码
LineChartData
是曲线图数据类,包括了如下部分:
lineTouchData
:数据触点配置数据,即触摸到数据点后如何显示;
gridData
:网格数据;
titlesData
:上下左右四个方位的标题栏(坐标轴栏)数据,可以根据自己需要配置坐标轴显示以及标题;
borderData
:边框数据,及是否要显示边框,以及如何显示边框;
lineBarsData
:数据点数组,可以在同一个图表中显示多条曲线。
minX
,maxX
,minY
和 MaxY
:即 X 轴和 Y 轴的最大最小值范围,可以根据需要设置范围,比如本篇 X 轴 0-15,而 Y 轴则是根据返回值设置最大最小值,以保证曲线显示在屏幕范围内。
再来看一下曲线数据点代码,这里我们对各个属性都加了注释了,就无需再介绍了,实际可以根据需要返回多条曲线和设置曲线的样式。
List<LineChartBarData> lineBarsData1(List<double> yData) {
double x = 1;
return [
LineChartBarData(
//曲线还是折线
isCurved: true,
//线条颜色
colors: [const Color(0xff4a99fa)],
//线粗细
barWidth: 2,
//是否圆形笔头
isStrokeCapRound: true,
//是否显示点数据
dotData: FlDotData(show: true),
//图形覆盖区域是否显示
belowBarData: BarAreaData(show: true),
//坐标(x,y) 点集合
spots: yData.map((value) {
FlSpot spot = FlSpot(x, value.toDouble());
x += 2;
return spot;
}).toList(),
),
];
}
复制代码
其他代码基本上是从官方的样例复制过来修改的,可以参考官网示例或本例的源代码:MobX状态管理代码(运行时请同时运行后端代码:配套后端代码(基于 ExpressJs))。
状态管理代码
有了上一篇《利用 VSCode 的代码模板提高 MobX 的编码效率》介绍的代码模板神器,编写状态代码相当轻松。只需要修改状态对象类型、名称、初始值,然后实现获取后端数据的 action 即可。代码如下:
import 'package:mobx/mobx.dart';
import 'chart_service.dart';
part 'chart_store.g.dart';
class ChartStore = ChartStoreBase with _$ChartStore;
abstract class ChartStoreBase with Store {
@observable
List<double> lineYData = [0, 0, 0, 0, 0, 0, 0];
@action
Future<void> featchLineData() async {
var response = await ChartService.getLines();
if (response?.statusCode == 200) {
lineYData =
List<double>.from(response.data.map((e) => e.toDouble()).toList());
}
}
}
复制代码
实际上自己写的状态代码才 4 行而已!
运行效果
运行效果如下,实际开发过程中可以根据项目需要更改曲线样式。
总结
从本篇我们更加能够体会 MobX 的简洁之处,真正地做到了状态和 UI 分离以及无感知刷新。通过 MobX 的代码生成器和模板代码可以大大减少我们的编码量,提高效率。本篇我们还引入了 fl_chart
这个效果酷炫的图表插件,这个插件基本上能够满足我们基本的线条图、柱状图、散点图和饼图的图表需要。
评论