跨平台开发 / 系统课时

封装加载和错误状态组件

封装加载和错误状态组件

本篇将把页面中重复出现的加载中、错误提示和重试操作封装成统一组件,让业务页面只关注数据展示,并保持交互和视觉的一致性。

学习目标

  • 理解为什么需要统一封装加载与错误状态。
  • 掌握使用 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 参数扩展,而不是不断增加组件内部判断。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装加载和错误状态组件

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

登录哪都通