跨平台开发 / 系统课时

封装统一的空状态组件

封装统一的空状态组件

本篇解决 Flutter 应用中无数据页面样式不统一的问题,通过封装空状态组件,让列表为空、搜索无结果和首次使用等场景拥有一致反馈,同时保持业务页面调用简单。

学习目标

  • 理解空状态组件包含的通用结构
  • 掌握通过参数控制提示内容和操作行为
  • 能够在不同业务页面复用空状态反馈

空状态组件解决什么问题

空状态不是简单显示一句“暂无数据”。优秀的空状态需要告诉用户当前发生了什么,以及下一步可以做什么。

常见场景包括:

  • 用户首次进入页面,还没有创建数据
  • 搜索条件没有匹配结果
  • 网络请求成功但返回空列表
  • 数据被删除后页面需要重新引导

如果每个页面自行实现,会出现图标、文字、按钮间距不一致的问题。统一组件可以集中管理这些视觉规则。

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
搜索结果为空时显示统一的空状态界面。
点击“清除搜索”后执行页面提供的清理逻辑。

避免空状态组件过度业务化

空状态组件不应该直接依赖列表、搜索控制器或网络请求状态。例如组件内部判断“接口失败”“用户未登录”等,会让它无法在其他页面使用。

更合理的方式是由业务层完成状态判断:

  • 页面判断当前状态类型
  • 页面选择对应提示文案
  • 空状态组件负责渲染内容
  • 用户操作通过回调返回页面

这种分离方式可以让同一个组件覆盖更多场景,同时避免组件随着业务增长不断膨胀。

统一体验时的扩展方向

当应用中存在大量空状态页面时,可以进一步抽取设计规范,例如统一图标尺寸、文本样式、按钮间距和动画效果。组件负责实现规范,页面负责提供业务语义,二者结合才能保持长期可维护性。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装统一的空状态组件

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

登录哪都通