跨平台开发 / 系统课时
处理首次加载和加载更多
处理首次加载和加载更多
首次加载和加载更多都在请求列表数据,但它们对界面的影响完全不同:首屏失败可以覆盖整页,下一页失败却不能清空已有内容。本节把两类状态拆开,并用可运行示例验证加载更多失败时旧数据仍然保留。
学习目标
- 区分首次加载、加载更多及其错误状态。
- 防止下一页请求覆盖已经展示的数据。
- 为首屏重试和页尾重试保留独立的 UI 反馈。
两类请求不能共用一个 loading
如果只维护一个 isLoading 和一个 error,首屏与页尾状态会互相覆盖。例如第二页失败后把 error 设为非空,界面可能误判为“整页加载失败”,把第一页已经显示的数据替换成错误页。
更稳妥的做法是保留两个加载标记,并让加载更多错误只作用于页尾。
| 场景 | 数据区 | 推荐反馈 |
|---|---|---|
| 首次加载中 | 还没有数据 | 全屏加载指示 |
| 首次加载失败 | 还没有数据 | 全屏错误与重试 |
| 加载更多中 | 保留已有数据 | 列表底部加载指示 |
| 加载更多失败 | 保留已有数据 | 列表底部错误与重试 |
用独立状态保护已有列表
下面的示例让第一页成功、第二页故意失败。重点观察:加载更多失败后,items 仍保留第一页内容,同时 loadMoreError 只记录页尾错误。
import 'dart:async';
class FeedController {
final List<String> items = [];
bool isInitialLoading = false;
bool isLoadingMore = false;
String? initialError;
String? loadMoreError;
int currentPage = 0;
bool hasMore = true;
Future<void> loadInitial() async {
if (isInitialLoading) return;
isInitialLoading = true;
initialError = null;
loadMoreError = null;
try {
final firstPage = await fetchPage(1);
items
..clear()
..addAll(firstPage);
currentPage = 1;
hasMore = firstPage.length == 3;
} catch (e) {
initialError = e.toString();
} finally {
isInitialLoading = false;
}
}
Future<void> loadMore() async {
if (isLoadingMore || !hasMore || items.isEmpty) return;
isLoadingMore = true;
loadMoreError = null;
final nextPage = currentPage + 1;
try {
final nextItems = await fetchPage(nextPage);
items.addAll(nextItems);
currentPage = nextPage;
hasMore = nextItems.length == 3;
} catch (e) {
// 只记录页尾错误,不清空第一页已经成功的数据。
loadMoreError = e.toString();
} finally {
isLoadingMore = false;
}
}
}
Future<List<String>> fetchPage(int page) async {
await Future<void>.delayed(const Duration(milliseconds: 10));
if (page == 1) {
return ['A', 'B', 'C'];
}
throw Exception('page $page request failed');
}
Future<void> main() async {
final controller = FeedController();
await controller.loadInitial();
print(
'after initial: items=${controller.items} '
'initialError=${controller.initialError}',
);
await controller.loadMore();
print(
'after loadMore: items=${controller.items} '
'loadMoreError=${controller.loadMoreError}',
);
}预期输出
after initial: items=[A, B, C] initialError=null
after loadMore: items=[A, B, C] loadMoreError=Exception: page 2 request failed这里第二页失败后 currentPage 仍为 1。下一次点击“重试加载更多”时,可以再次请求第 2 页,而不是跳到第 3 页。
在 Flutter 界面中映射状态
片段示例:下面假设 controller 已由页面持有,并且状态变化后会通过 setState、ChangeNotifier、Riverpod 或其他状态管理方案触发重建。核心是先判断有没有数据,再决定显示整页反馈还是页尾反馈。
if (controller.items.isEmpty && controller.isInitialLoading) {
return const Center(child: CircularProgressIndicator());
}
if (controller.items.isEmpty && controller.initialError != null) {
return Center(
child: Text('加载失败:${controller.initialError}'),
);
}
// 已有数据时继续渲染列表;isLoadingMore 和 loadMoreError
// 应放在列表底部,而不是替换整个页面。该片段的验证方法是:首次请求期间只显示全屏加载;第一页成功后列表出现;随后加载更多失败时列表仍保留,错误提示只出现在底部区域。
避免重复请求和状态串线
loadMore 开始时先检查 isLoadingMore,可以防止滚动监听连续触发同一页请求。类似地,没有首屏数据时不要执行加载更多,否则首屏和下一页可能并发写入同一个列表。
搜索条件变化时,还要丢弃旧查询的分页状态:清空列表、重置页码和错误,再执行新的首次加载。如果旧请求可能晚于新请求返回,还应给请求加序号或取消机制,避免过期响应覆盖新结果。
把首屏状态和页尾状态分开后,页面就能做到“首屏失败时明确阻断,加载更多失败时保留成果”,这也是分页列表避免闪烁、清空和跳页的基础。