跨平台开发 / 系统课时

用 ref.read 执行一次性操作

用 ref.read 执行一次性操作

本篇解决事件回调中如何获取 Provider 数据或调用状态修改方法的问题。通过 ref.read 可以在按钮点击、提交表单等一次性场景中访问状态,同时避免建立不需要的持续监听关系。

学习目标

  • 理解 ref.read 与持续订阅方式的区别
  • 掌握在事件处理中读取 Provider 的正确写法
  • 避免在错误位置使用 read 导致状态不同步问题

ref.read 适合解决什么问题

在 Riverpod 中,组件通常通过订阅 Provider 获取状态变化。但并不是所有代码都需要随着状态变化重新执行,例如用户点击按钮后执行保存、刷新、登录等动作,这些操作只需要在触发瞬间获取 Provider 或调用方法。

ref.read 的特点是读取当前值,但不会建立监听关系。调用完成后,后续状态变化不会主动触发当前代码重新执行。

在事件回调中调用 Provider 方法

下面示例展示一个计数器场景。界面只在按钮点击时调用 notifier 的方法,不需要因为按钮操作本身建立额外监听。

dart
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

final counterProvider = NotifierProvider<CounterNotifier, int>(CounterNotifier.new);

class CounterNotifier extends Notifier<int> {
  @override
  int build() => 0;

  void increment() {
    state++;
  }
}

class CounterButton extends ConsumerWidget {
  const CounterButton({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    return ElevatedButton(
      onPressed: () {
        // 事件触发时读取 notifier,不创建持续监听
        ref.read(counterProvider.notifier).increment();
      },
      child: const Text('增加'),
    );
  }
}

预期结果

text
点击“增加”按钮后,CounterNotifier 的 state 增加 1。
按钮回调只执行一次,不会因为其他状态变化自动重复执行。

ref.read 与 ref.watch 的边界

两者解决的问题不同。watch 用于构建界面依赖,状态变化后会触发重新构建;read 用于主动获取或调用,不负责更新界面。

使用场景 推荐方式
Text 显示当前状态 ref.watch
点击按钮提交操作 ref.read
调用 notifier 方法 ref.read(provider.notifier)
需要根据状态变化刷新界面 ref.watch

不要在 build 方法中大量使用 ref.read 获取需要展示的数据,因为读取结果不会驱动界面更新。当数据需要响应变化时,应建立明确的订阅关系。

使用 ref.read 时的常见错误

一个常见问题是在 UI 渲染阶段误用 read:先读取一次状态,然后期望界面自动更新。这会造成状态已经变化,但组件仍显示旧数据。

另一个问题是在异步操作中保存过期引用。对于长时间运行的任务,应根据业务需要重新读取当前状态,而不是假设之前读取的值始终有效。

在事件驱动代码中,ref.read 的价值是明确表达“我现在需要执行一次操作”,让状态访问行为更加可预测。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ref.read 执行一次性操作

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

登录哪都通