跨平台开发 / 系统课时
区分 UI 状态和业务状态
区分 UI 状态和业务状态
同样是“会变化的值”,输入框焦点、面板展开和购物车数量并不该放在同一层。判断关键不是它是否会刷新界面,而是谁拥有它、离开当前组件后是否仍有业务意义。把短生命周期交互留在组件,把可共享、可复用、受业务规则约束的数据交给 Notifier。
学习目标
- 判断焦点、展开状态等临时交互是否应保留在组件内部
- 识别具有业务含义、需要共享或统一修改规则的状态
- 用组件本地状态与
Notifier划清状态所有权边界
先看状态属于谁
UI 状态描述“这个组件现在怎么显示或怎么交互”。它通常只服务于当前控件,组件销毁后也没有继续保存的价值,例如 FocusNode、某个说明区是否展开、当前动画进度。
业务状态描述“应用正在处理什么事实”。它往往会被多个控件读取,或者修改时需要遵守统一规则,例如购物车数量、订单草稿、收藏列表、筛选条件对应的查询结果。这样的状态更适合由 Notifier 对外暴露。
| 判断问题 | 更偏向组件本地状态 | 更偏向 Notifier |
|---|---|---|
| 只影响当前控件的交互吗 | 是 | 否 |
| 当前组件销毁后还有意义吗 | 否 | 是 |
| 多个页面或组件需要读取吗 | 通常否 | 经常是 |
| 修改时存在业务规则吗 | 很少 | 经常有 |
用一个页面划清边界
下面示例假定项目已经安装 flutter_riverpod。文本框焦点与“是否展开说明”只属于当前页面,因此放在 ConsumerState 中;购物车数量具有业务含义,并可能被其他页面读取,因此交给 Notifier。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
final cartCountProvider = NotifierProvider<CartCount, int>(CartCount.new);
class CartCount extends Notifier<int> {
@override
int build() => 0;
void addOne() {
state++;
}
}
void main() {
runApp(
const ProviderScope(
child: MaterialApp(home: DemoPage()),
),
);
}
class DemoPage extends ConsumerStatefulWidget {
const DemoPage({super.key});
@override
ConsumerState<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends ConsumerState<DemoPage> {
final _focusNode = FocusNode();
bool _expanded = false;
@override
void dispose() {
_focusNode.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final cartCount = ref.watch(cartCountProvider);
return Scaffold(
appBar: AppBar(title: const Text('状态边界')),
body: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
TextField(
focusNode: _focusNode,
decoration: const InputDecoration(labelText: '备注'),
),
SwitchListTile(
contentPadding: EdgeInsets.zero,
title: const Text('展开说明'),
value: _expanded,
onChanged: (value) => setState(() => _expanded = value),
),
if (_expanded) const Text('这段说明只影响当前页面。'),
FilledButton(
onPressed: () {
ref.read(cartCountProvider.notifier).addOne();
},
child: const Text('加入购物车'),
),
Text('购物车数量:$cartCount'),
],
),
),
);
}
}预期结果
页面首次打开时显示“购物车数量:0”。
切换“展开说明”只改变当前页面的展开区域。
点击“加入购物车”后数量依次变为 1、2、3……
输入框获得或失去焦点时,不会修改 cartCountProvider。这个拆分还有一个直接好处:UI 只负责交互细节,业务修改入口集中在 CartCount.addOne()。如果将来要限制最大数量、记录埋点或联动库存检查,只需修改 Notifier,而不必在多个按钮回调里复制规则。
不要用“是否需要重建”作为标准
一个值会触发界面重建,并不代表它就是业务状态。_expanded 改变后同样需要 setState,但它没有跨组件的业务含义;反过来,购物车数量即使当前页面只显示一次,也仍然可能属于应用级业务数据。
更可靠的判断顺序是:先看生命周期,再看共享范围,最后看修改规则。只要状态脱离当前组件仍然有意义,或者多个入口必须以一致方式修改它,就应优先考虑 Notifier。
边界情况怎么处理
有些状态名字看起来像 UI 状态,却需要跨组件共享,例如一个页面级筛选条件同时控制工具栏、列表和结果统计。此时共享需求已经超过单个控件,可以提升到 Provider 或 Notifier;但这仍不意味着所有焦点、滚动位置都应该全局化。
反过来,业务表单中的“文本框当前是否聚焦”依然是 UI 状态,而“用户已填写但尚未提交的订单草稿”通常是业务状态。判断时关注状态表达的事实,而不是它出现在哪个 Widget 里。
把状态放在最小但足够的作用域中:短命、局部、纯交互的值留在组件;可共享、可复用、受业务规则约束的值进入 Notifier。这样既避免 Provider 过度膨胀,也让业务状态拥有清晰、可测试的修改入口。