跨平台开发 / 系统课时
拆分筛选条件和列表结果
拆分筛选条件和列表结果
本篇解决筛选页面状态混杂的问题,将用户输入条件与查询结果拆分管理,并利用 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。
按自己的节奏,确认真正理解。