跨平台开发 / 系统课时

处理首次加载和加载更多

处理首次加载和加载更多

首次加载和加载更多都在请求列表数据,但它们对界面的影响完全不同:首屏失败可以覆盖整页,下一页失败却不能清空已有内容。本节把两类状态拆开,并用可运行示例验证加载更多失败时旧数据仍然保留。

学习目标

  • 区分首次加载、加载更多及其错误状态。
  • 防止下一页请求覆盖已经展示的数据。
  • 为首屏重试和页尾重试保留独立的 UI 反馈。

两类请求不能共用一个 loading

如果只维护一个 isLoading 和一个 error,首屏与页尾状态会互相覆盖。例如第二页失败后把 error 设为非空,界面可能误判为“整页加载失败”,把第一页已经显示的数据替换成错误页。

更稳妥的做法是保留两个加载标记,并让加载更多错误只作用于页尾。

场景 数据区 推荐反馈
首次加载中 还没有数据 全屏加载指示
首次加载失败 还没有数据 全屏错误与重试
加载更多中 保留已有数据 列表底部加载指示
加载更多失败 保留已有数据 列表底部错误与重试

用独立状态保护已有列表

下面的示例让第一页成功、第二页故意失败。重点观察:加载更多失败后,items 仍保留第一页内容,同时 loadMoreError 只记录页尾错误。

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

预期输出

text
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 或其他状态管理方案触发重建。核心是先判断有没有数据,再决定显示整页反馈还是页尾反馈。

dart
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,可以防止滚动监听连续触发同一页请求。类似地,没有首屏数据时不要执行加载更多,否则首屏和下一页可能并发写入同一个列表。

搜索条件变化时,还要丢弃旧查询的分页状态:清空列表、重置页码和错误,再执行新的首次加载。如果旧请求可能晚于新请求返回,还应给请求加序号或取消机制,避免过期响应覆盖新结果。

把首屏状态和页尾状态分开后,页面就能做到“首屏失败时明确阻断,加载更多失败时保留成果”,这也是分页列表避免闪烁、清空和跳页的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理首次加载和加载更多

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

登录哪都通