跨平台开发 / 系统课时
用 NotifierProvider 暴露状态
用 NotifierProvider 暴露状态
Notifier 负责持有和更新状态,NotifierProvider 则把它接入 Riverpod 的 Provider 系统。本节用一个最小计数器串起声明、订阅和调用路径,让 Widget 能自动响应状态变化。
学习目标
- 能声明
NotifierProvider<NotifierType, StateType>并暴露Notifier的状态 - 能在
ConsumerWidget中用ref.watch订阅状态 - 能区分读取状态与取得
notifier执行业务方法的用法
定义并暴露 Notifier
Notifier 的 build() 返回初始状态。Provider 的第一个泛型参数是 Notifier 类型,第二个泛型参数是它对外暴露的状态类型。声明完成后,Widget 订阅的是 counterProvider 的状态值,而不是直接持有 CounterNotifier 实例。
下面的 main.dart 假设项目已经添加 flutter_riverpod 依赖,可以直接替换后运行:
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
class CounterNotifier extends Notifier<int> {
@override
int build() => 0;
// 状态修改仍由 Notifier 负责,Widget 只触发意图。
void increment() {
state++;
}
}
final counterProvider =
NotifierProvider<CounterNotifier, int>(CounterNotifier.new);
void main() {
runApp(
const ProviderScope(
child: MyApp(),
),
);
}
class MyApp extends ConsumerWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
// watch 建立订阅;状态变化后,这里会重新构建。
final count = ref.watch(counterProvider);
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: const Text('NotifierProvider')),
body: Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Text('当前计数:$count'),
const SizedBox(height: 12),
FilledButton(
onPressed: () {
ref.read(counterProvider.notifier).increment();
},
child: const Text('+1'),
),
],
),
),
),
);
}
}预期结果
页面初始显示“当前计数:0”。每点击一次“+1”,数字增加 1,文本自动刷新。
订阅状态与取得控制器
ref.watch(counterProvider) 返回当前的 int 状态,并把当前 Widget 注册为订阅者。之后只要 state 发生变化,Riverpod 就会让依赖这个值的构建逻辑再次执行。
按钮点击属于一次性事件,不需要订阅 CounterNotifier 实例,因此使用 ref.read(counterProvider.notifier)。这里的 .notifier 很关键:没有它时,ref.read(counterProvider) 读到的仍然只是当前状态值。
| 写法 | 得到的内容 | 典型位置 |
|---|---|---|
ref.watch(counterProvider) |
当前状态,并持续订阅变化 | Widget 的 build() |
ref.read(counterProvider) |
当前状态,但不建立订阅 | 点击等事件回调 |
ref.read(counterProvider.notifier) |
CounterNotifier 实例 |
调用 increment() 等方法 |
为什么 Provider 是必要的一层
如果 Widget 自己创建 CounterNotifier,它的生命周期、依赖关系和状态通知就脱离了 Riverpod。通过 NotifierProvider,状态实例由 Provider 容器管理,Widget 只声明“我需要这个状态”,Riverpod 负责把状态变化传播到订阅者。
因此,日常写法可以记成两条:渲染数据用 ref.watch(provider),触发动作时用 ref.read(provider.notifier).method()。这能把 UI 的订阅关系与状态对象的管理方式保持一致。