跨平台开发 / 系统课时
封装加载和错误状态组件
封装加载和错误状态组件
本篇将把页面中重复出现的加载中、错误提示和重试操作封装成统一组件,让业务页面只关注数据展示,并保持交互和视觉的一致性。
学习目标
- 理解为什么需要统一封装加载与错误状态。
- 掌握使用 Flutter Widget 组合实现状态组件。
- 能在业务页面中复用状态组件处理异步数据场景。
分离页面状态与业务内容
一个典型的数据页面通常包含三个阶段:等待数据、加载失败、数据成功展示。如果每个页面都自行实现这些状态,很容易出现按钮样式、间距和提示文本不一致的问题。
封装状态组件的核心思路是让页面根据状态选择不同 UI,而不是让业务代码重复创建各种提示界面。
创建可复用状态组件
下面的示例定义一个简单的状态组件,通过参数控制显示内容和重试行为。
dart
import 'package:flutter/material.dart';
class LoadStateView extends StatelessWidget {
final String? errorMessage;
final VoidCallback? onRetry;
const LoadStateView({super.key, this.errorMessage, this.onRetry});
@override
Widget build(BuildContext context) {
if (errorMessage != null) {
return Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Text(errorMessage!),
const SizedBox(height: 12),
ElevatedButton(
onPressed: onRetry,
child: const Text('重新加载'),
),
],
),
);
}
return const Center(
child: CircularProgressIndicator(),
);
}
}预期结果
text
页面加载时显示转圈进度指示器。
传入 errorMessage 后显示错误文本和重新加载按钮。
点击按钮会执行传入的 onRetry 方法。在业务页面中组合使用
状态组件通常作为页面内容的一部分,根据请求状态切换。业务层只需要维护数据状态,不需要关心具体布局。
例如:
dart
Widget buildContent(bool loading, String? error) {
if (loading || error != null) {
return LoadStateView(
errorMessage: error,
onRetry: fetchData,
);
}
return const Text('数据列表内容');
}预期结果
text
loading=true 时显示加载状态。
error 不为空时显示错误状态。
两者都不存在时显示正常业务内容。设计状态组件时的边界
通用状态组件应该负责稳定的展示和交互,例如图标、提示文字、按钮样式。它不应该直接调用接口、管理网络请求或修改业务数据。
如果不同页面需要完全不同的错误处理方式,可以通过插槽参数、Builder 或自定义 Widget 参数扩展,而不是不断增加组件内部判断。
按自己的节奏,确认真正理解。