跨平台开发 / 系统课时
用 Notifier 定义可变状态
用 Notifier 定义可变状态
当状态需要由用户操作或业务规则主动修改时,可以用 Notifier 把“当前状态”和“修改方法”集中在一个业务对象中,再由 NotifierProvider 暴露给界面。本节用计数器完成最小可运行结构。
学习目标
- 会继承
Notifier<T>并通过build()返回初始状态。 - 会使用
NotifierProvider暴露状态和业务方法。 - 会区分
ref.watch(provider)与ref.read(provider.notifier)的职责。
Notifier 负责状态和修改规则
Notifier<T> 中的 state 保存当前值,build() 返回初始值,也可以在其中读取其他 Provider 作为初始化或派生依据。界面不直接修改 state,而是调用 Notifier 暴露的方法,让状态变化集中在一个可测试的业务入口。
NotifierProvider<Counter, int> 的两个类型参数分别表示 Notifier 类型和状态类型。页面读取 counterProvider 得到 int,读取 counterProvider.notifier 才得到可以执行 increment()、reset() 的 Counter 实例。
创建并使用 Notifier
下面是一个完整的 Flutter 示例。点击按钮会调用 Notifier 方法修改 state,所有正在 watch 该 Provider 的组件会收到新值并重建。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
final counterProvider = NotifierProvider<Counter, int>(Counter.new);
class Counter extends Notifier<int> {
@override
int build() {
return 0;
}
void increment() {
// 状态修改集中在 Notifier 内,UI 只负责发出意图。
state = state + 1;
}
void reset() {
state = 0;
}
}
void main() {
runApp(const ProviderScope(child: MyApp()));
}
class MyApp extends ConsumerWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final count = ref.watch(counterProvider);
return MaterialApp(
home: Scaffold(
body: Center(
child: Text('当前计数:$count'),
),
floatingActionButton: FloatingActionButton(
onPressed: () {
ref.read(counterProvider.notifier).increment();
},
child: const Icon(Icons.add),
),
),
);
}
}预期结果
启动时页面显示:当前计数:0
每点击一次加号按钮,计数依次变为 1、2、3……这里有一条很重要的读写分工:ref.watch(counterProvider) 用于订阅状态,因此计数变化时界面会更新;ref.read(counterProvider.notifier) 用于拿到动作对象并执行方法,不需要让按钮回调本身建立订阅。
build 不是 Widget 的 build
Notifier 的 build() 与 Widget 的 build() 名称相同,但职责不同。它用于创建 Notifier 的初始状态,并声明 Notifier 自身依赖的其他 Provider。它可以在依赖变化时重新执行,因此不适合在这里放必须“只执行一次”的不可重复副作用。
如果初始值只是常量,直接返回即可;如果初始状态取决于另一个 Provider,可以在 build() 中使用 ref.watch。这样依赖关系仍由 Riverpod 管理,而不是通过构造函数手动传入 Ref。
把业务动作留在 Notifier 内
当状态修改开始出现校验、组合更新或异步流程时,不要让多个 Widget 分别复制这些规则。界面应表达“用户想做什么”,例如调用 increment()、reset();Notifier 决定状态如何变化。
这种边界让 UI 保持声明式:Widget 负责观察状态和触发动作,Notifier 负责维护可变业务状态。只要状态修改都经过明确方法,后续增加限制条件、日志或测试时,就不必在多个界面中同步修改逻辑。