跨平台开发 / 系统课时
处理加载、空数据和错误状态
处理加载、空数据和错误状态
网络页面不会一直处于成功状态,用户等待时需要看到加载反馈,没有数据时需要合理提示,请求失败时需要提供恢复入口。本篇将完善 Flutter 页面常见的 loading、empty、error 和 retry 状态处理方式。
学习目标
- 理解异步页面中的多状态管理方式
- 掌握加载、空数据和错误状态的 UI 表达
- 能够设计支持重试的数据请求流程
网络页面为什么需要多状态
一个接口请求通常存在多个阶段:开始请求、等待响应、获取数据、请求失败。只显示最终数据会导致用户面对空白页面或无响应状态。
常见页面状态包括:
| 状态 | 用户看到的内容 | 触发条件 |
|---|---|---|
| loading | 加载提示 | 请求正在执行 |
| success | 数据列表或详情 | 请求成功且有数据 |
| empty | 空状态提示 | 请求成功但没有数据 |
| error | 错误提示和重试按钮 | 请求失败 |
实际开发中,可以使用状态对象统一描述这些情况。
定义页面状态模型
下面示例使用简单状态类表示请求结果:
dart
sealed class ViewState<T> {}
class Loading<T> extends ViewState<T> {}
class Success<T> extends ViewState<T> {
final T data;
Success(this.data);
}
class Empty<T> extends ViewState<T> {}
class ErrorState<T> extends ViewState<T> {
final String message;
ErrorState(this.message);
}
void main() {
ViewState<List<String>> state = Success(['Flutter']);
if (state is Success<List<String>>) {
print(state.data);
}
}预期输出
text
[Flutter]通过状态对象,界面层只需要根据当前状态选择展示内容,不需要重复判断请求是否完成。
在页面中展示不同状态
Widget 通常根据状态分支渲染不同界面:
dart
Widget buildContent(ViewState<List<String>> state) {
return switch (state) {
Loading() => const CircularProgressIndicator(),
Empty() => const Text('暂无数据'),
Success(data: final items) => ListView(
children: items.map(Text.new).toList(),
),
ErrorState(message: final message) => Text(message),
};
}预期结果
text
loading 状态显示进度指示器;
empty 状态显示暂无数据;
success 状态显示列表内容;
error 状态显示错误信息。这种方式比在 Widget 中散落多个布尔变量更容易维护,例如 isLoading、hasError、hasData 同时存在时,很容易产生互相冲突的组合。
设计错误恢复和重试
错误状态不应该只是显示错误文字,用户通常需要再次尝试请求。重试逻辑应该重新执行请求流程,而不是直接修改界面状态。
例如:
dart
Future<void> retry() async {
state = Loading();
try {
final data = await loadItems();
state = data.isEmpty ? Empty() : Success(data);
} catch (e) {
state = ErrorState('加载失败,请稍后重试');
}
}预期结果
text
请求开始时进入 Loading;
成功返回数据进入 Success 或 Empty;
异常进入 ErrorState。页面状态设计的重点是覆盖真实用户路径。加载、空数据和错误并不是异常分支,而是网络应用中的正常情况。将这些状态显式建模,可以让 Flutter 页面行为更稳定,也更容易扩展新的交互状态。
按自己的节奏,确认真正理解。