跨平台开发 / 系统课时
封装通用信息卡片组件
封装通用信息卡片组件
本篇解决 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 构造减少无效重建
但不要过早增加大量配置参数。如果一个组件拥有十几个布尔参数,通常说明它承担了过多业务职责。
什么时候不该使用通用卡片
如果两个页面只是视觉上类似,但交互逻辑、数据生命周期完全不同,不应该强行复用同一个组件。可以提取更小的基础组件,例如标题区域、状态标签或按钮,而不是创建一个包含所有逻辑的大卡片。
好的业务组件应该让调用方更简单,同时保持自身职责清晰。信息卡片的价值在于统一展示方式,而不是替代整个页面的业务代码。
按自己的节奏,确认真正理解。