跨平台开发 / 系统课时
封装统一的空状态组件
封装统一的空状态组件
本篇解决 Flutter 应用中无数据页面样式不统一的问题,通过封装空状态组件,让列表为空、搜索无结果和首次使用等场景拥有一致反馈,同时保持业务页面调用简单。
学习目标
- 理解空状态组件包含的通用结构
- 掌握通过参数控制提示内容和操作行为
- 能够在不同业务页面复用空状态反馈
空状态组件解决什么问题
空状态不是简单显示一句“暂无数据”。优秀的空状态需要告诉用户当前发生了什么,以及下一步可以做什么。
常见场景包括:
- 用户首次进入页面,还没有创建数据
- 搜索条件没有匹配结果
- 网络请求成功但返回空列表
- 数据被删除后页面需要重新引导
如果每个页面自行实现,会出现图标、文字、按钮间距不一致的问题。统一组件可以集中管理这些视觉规则。

设计可复用参数
空状态组件通常需要暴露以下参数:
| 参数 | 作用 |
|---|---|
| image 或 icon | 表示当前状态的视觉元素 |
| title | 当前状态标题 |
| description | 补充说明 |
| actionText | 操作按钮文字 |
| onAction | 用户点击后的行为 |
组件只负责展示和触发事件,不负责判断为什么为空。业务页面应该根据自己的状态传入不同内容。
实现基础空状态组件
下面实现一个可复用的空状态 Widget。
dart
import 'package:flutter/material.dart';
class EmptyState extends StatelessWidget {
final IconData icon;
final String title;
final String description;
final String? actionText;
final VoidCallback? onAction;
const EmptyState({
super.key,
required this.icon,
required this.title,
required this.description,
this.actionText,
this.onAction,
});
@override
Widget build(BuildContext context) {
return Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(icon, size: 64),
Text(title),
Text(description),
if (actionText != null)
ElevatedButton(
onPressed: onAction,
child: Text(actionText!),
),
],
),
);
}
}预期结果
text
页面中央显示状态图标、标题、描述文本。
如果传入 actionText,则额外显示操作按钮并执行回调。在业务页面中使用
例如搜索页面没有结果时,可以由页面决定提示内容。
dart
EmptyState(
icon: Icons.search_off,
title: '没有找到结果',
description: '尝试修改关键词后重新搜索',
actionText: '清除搜索',
onAction: () {
controller.clear();
},
)预期结果
text
搜索结果为空时显示统一的空状态界面。
点击“清除搜索”后执行页面提供的清理逻辑。避免空状态组件过度业务化
空状态组件不应该直接依赖列表、搜索控制器或网络请求状态。例如组件内部判断“接口失败”“用户未登录”等,会让它无法在其他页面使用。
更合理的方式是由业务层完成状态判断:
- 页面判断当前状态类型
- 页面选择对应提示文案
- 空状态组件负责渲染内容
- 用户操作通过回调返回页面
这种分离方式可以让同一个组件覆盖更多场景,同时避免组件随着业务增长不断膨胀。
统一体验时的扩展方向
当应用中存在大量空状态页面时,可以进一步抽取设计规范,例如统一图标尺寸、文本样式、按钮间距和动画效果。组件负责实现规范,页面负责提供业务语义,二者结合才能保持长期可维护性。
按自己的节奏,确认真正理解。