跨平台开发 / 系统课时

封装通用信息卡片组件

封装通用信息卡片组件

本篇解决 Flutter 页面中信息卡片重复编写的问题,通过提取标题、副标题、图标、状态和点击行为,构建可组合、可维护的业务组件,让相似页面保持一致体验。

学习目标

  • 理解业务卡片组件拆分的边界和设计原则
  • 掌握使用参数控制卡片内容与行为的方法
  • 能够封装支持复用的信息展示组件

为什么需要通用信息卡片

在真实业务页面中,订单卡片、用户信息卡片、设置入口卡片通常具有相似结构:顶部展示图标和标题,中间显示描述信息,底部可能包含状态或操作入口。如果每个页面单独编写,会导致样式调整需要修改大量代码。

通用组件的目标不是把所有场景强行统一,而是提取稳定结构,把变化部分通过参数暴露出来。

一个适合复用的信息卡片通常包含以下可变化内容:

  • 标题文本
  • 副标题或描述
  • 左侧图标
  • 状态标签
  • 点击回调
  • 是否展示边框、阴影等视觉配置

设计组件参数边界

封装前需要区分哪些内容属于组件职责,哪些内容应该由业务页面决定。

内容 是否放入组件 原因
卡片布局结构 是 所有使用场景共享
标题和描述 是 属于展示数据
具体业务跳转逻辑 否 由页面决定
网络请求 否 组件不应管理业务状态
点击事件通知 是 通过回调交给外部处理

下面实现一个简单的信息卡片组件。该示例可以直接放入 Flutter 项目中使用。

dart
import 'package:flutter/material.dart';

class InfoCard extends StatelessWidget {
  final IconData icon;
  final String title;
  final String subtitle;
  final String? status;
  final VoidCallback? onTap;

  const InfoCard({
    super.key,
    required this.icon,
    required this.title,
    required this.subtitle,
    this.status,
    this.onTap,
  });

  @override
  Widget build(BuildContext context) {
    return Card(
      child: ListTile(
        leading: Icon(icon),
        title: Text(title),
        subtitle: Text(subtitle),
        trailing: status == null ? null : Text(status!),
        onTap: onTap,
      ),
    );
  }
}

使用时只需要传入业务数据,不需要重新定义布局。

dart
InfoCard(
  icon: Icons.person,
  title: '张三',
  subtitle: '普通用户',
  status: '在线',
  onTap: () {
    Navigator.pushNamed(context, '/profile');
  },
)

预期结果

text
页面显示一个包含用户图标、标题、副标题和状态文本的信息卡片。
点击卡片后执行传入的页面跳转逻辑。

提升组件复用能力

随着业务复杂度增加,可以继续抽象稳定能力,例如:

  • 使用 Widget 类型参数支持自定义尾部区域
  • 使用 Theme 获取统一颜色和间距
  • 增加 loading 状态展示异步数据加载过程
  • 使用 const 构造减少无效重建

但不要过早增加大量配置参数。如果一个组件拥有十几个布尔参数,通常说明它承担了过多业务职责。

什么时候不该使用通用卡片

如果两个页面只是视觉上类似,但交互逻辑、数据生命周期完全不同,不应该强行复用同一个组件。可以提取更小的基础组件,例如标题区域、状态标签或按钮,而不是创建一个包含所有逻辑的大卡片。

好的业务组件应该让调用方更简单,同时保持自身职责清晰。信息卡片的价值在于统一展示方式,而不是替代整个页面的业务代码。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装通用信息卡片组件

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

登录哪都通