跨平台开发 / 系统课时

拆分筛选条件和列表结果

拆分筛选条件和列表结果

本篇解决筛选页面状态混杂的问题,将用户输入条件与查询结果拆分管理,并利用 Riverpod 的依赖关系让筛选变化自动触发数据刷新。

学习目标

  • 理解筛选条件状态与列表结果状态分离的设计方式
  • 使用 Riverpod Provider 组合管理查询依赖
  • 实现筛选变化后自动重新加载列表数据

为什么要拆分筛选条件和结果数据

在列表页面中,搜索关键词、分类、排序方式等属于用户输入状态,而接口返回的数据属于异步结果状态。将两者放在同一个状态对象中,会导致修改筛选条件时难以控制刷新时机,也容易产生旧结果覆盖新请求的问题。

拆分后,筛选条件只负责描述当前查询意图,结果 Provider 根据条件变化重新计算自己的状态。Riverpod 会自动追踪依赖,当条件变化时重新执行关联逻辑。

使用 Provider 组合筛选和查询

下面示例使用一个筛选条件对象和一个异步列表 Provider。实际项目中可以继续扩展分页、排序等字段。

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

class ProductFilter {
  final String keyword;

  const ProductFilter({this.keyword = ''});
}

final productFilterProvider = StateProvider<ProductFilter>((ref) {
  return const ProductFilter();
});

final productListProvider = FutureProvider<List<String>>((ref) async {
  final filter = ref.watch(productFilterProvider);

  // 根据当前筛选条件请求数据,条件变化会触发重新执行。
  await Future.delayed(const Duration(milliseconds: 300));
  return ['result for ${filter.keyword}'];
});

预期输出

text
用户修改筛选条件后,productListProvider 自动重新执行,并返回对应关键词的数据。

更新筛选条件

页面组件只需要修改筛选状态,不需要手动调用刷新方法。

dart
ref.read(productFilterProvider.notifier).state =
    const ProductFilter(keyword: 'flutter');

预期结果

text
productFilterProvider 状态变为 keyword=flutter。
productListProvider 检测到依赖变化,重新加载列表数据。

常见边界问题

筛选条件变化频繁时,不应直接对每次输入立即请求接口。搜索框通常需要增加防抖,将连续输入合并后再更新查询条件。

如果结果数据需要保留上一页内容,可以进一步使用 AsyncNotifier 或自定义状态对象,把加载中、成功、失败等状态统一表达,而不是让 UI 自己拼接多个 Provider。

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

目录与阅读设置

阅读设置

17

记录一个想法

拆分筛选条件和列表结果

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

登录哪都通