跨平台开发 / 系统课时

用 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 依赖,可以直接替换后运行:

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

预期结果

text
页面初始显示“当前计数:0”。每点击一次“+1”,数字增加 1,文本自动刷新。

NotifierProvider 连接 Notifier 与 Widget 的数据流

订阅状态与取得控制器

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 的订阅关系与状态对象的管理方式保持一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 NotifierProvider 暴露状态

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

登录哪都通