跨平台开发 / 系统课时

区分 UI 状态和业务状态

区分 UI 状态和业务状态

同样是“会变化的值”,输入框焦点、面板展开和购物车数量并不该放在同一层。判断关键不是它是否会刷新界面,而是谁拥有它、离开当前组件后是否仍有业务意义。把短生命周期交互留在组件,把可共享、可复用、受业务规则约束的数据交给 Notifier。

学习目标

  • 判断焦点、展开状态等临时交互是否应保留在组件内部
  • 识别具有业务含义、需要共享或统一修改规则的状态
  • 用组件本地状态与 Notifier 划清状态所有权边界

先看状态属于谁

UI 状态描述“这个组件现在怎么显示或怎么交互”。它通常只服务于当前控件,组件销毁后也没有继续保存的价值,例如 FocusNode、某个说明区是否展开、当前动画进度。

业务状态描述“应用正在处理什么事实”。它往往会被多个控件读取,或者修改时需要遵守统一规则,例如购物车数量、订单草稿、收藏列表、筛选条件对应的查询结果。这样的状态更适合由 Notifier 对外暴露。

判断问题 更偏向组件本地状态 更偏向 Notifier
只影响当前控件的交互吗 是 否
当前组件销毁后还有意义吗 否 是
多个页面或组件需要读取吗 通常否 经常是
修改时存在业务规则吗 很少 经常有

用一个页面划清边界

下面示例假定项目已经安装 flutter_riverpod。文本框焦点与“是否展开说明”只属于当前页面,因此放在 ConsumerState 中;购物车数量具有业务含义,并可能被其他页面读取,因此交给 Notifier。

dart
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'),
          ],
        ),
      ),
    );
  }
}

预期结果

text
页面首次打开时显示“购物车数量:0”。
切换“展开说明”只改变当前页面的展开区域。
点击“加入购物车”后数量依次变为 1、2、3……
输入框获得或失去焦点时,不会修改 cartCountProvider。

这个拆分还有一个直接好处:UI 只负责交互细节,业务修改入口集中在 CartCount.addOne()。如果将来要限制最大数量、记录埋点或联动库存检查,只需修改 Notifier,而不必在多个按钮回调里复制规则。

不要用“是否需要重建”作为标准

一个值会触发界面重建,并不代表它就是业务状态。_expanded 改变后同样需要 setState,但它没有跨组件的业务含义;反过来,购物车数量即使当前页面只显示一次,也仍然可能属于应用级业务数据。

更可靠的判断顺序是:先看生命周期,再看共享范围,最后看修改规则。只要状态脱离当前组件仍然有意义,或者多个入口必须以一致方式修改它,就应优先考虑 Notifier。

边界情况怎么处理

有些状态名字看起来像 UI 状态,却需要跨组件共享,例如一个页面级筛选条件同时控制工具栏、列表和结果统计。此时共享需求已经超过单个控件,可以提升到 Provider 或 Notifier;但这仍不意味着所有焦点、滚动位置都应该全局化。

反过来,业务表单中的“文本框当前是否聚焦”依然是 UI 状态,而“用户已填写但尚未提交的订单草稿”通常是业务状态。判断时关注状态表达的事实,而不是它出现在哪个 Widget 里。

把状态放在最小但足够的作用域中:短命、局部、纯交互的值留在组件;可共享、可复用、受业务规则约束的值进入 Notifier。这样既避免 Provider 过度膨胀,也让业务状态拥有清晰、可测试的修改入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 UI 状态和业务状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通