跨平台开发 / 系统课时

用 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 的组件会收到新值并重建。

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

预期结果

text
启动时页面显示:当前计数: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 负责维护可变业务状态。只要状态修改都经过明确方法,后续增加限制条件、日志或测试时,就不必在多个界面中同步修改逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Notifier 定义可变状态

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

登录哪都通