跨平台开发 / 系统课时
用 Widget 参数支持内容插槽
用 Widget 参数支持内容插槽
复杂业务组件往往无法提前决定所有展示内容。通过接收 Widget 参数,可以让外部传入任意布局片段,实现类似插槽的组合能力。本篇学习如何使用 child、header 和 trailing 等参数提升组件灵活性。
学习目标
- 理解 Widget 参数与普通数据参数的区别。
- 掌握通过 child 和命名 Widget 参数实现内容组合。
- 能够设计支持扩展布局的复用组件。
理解 Widget 参数的组合思想
Flutter 推崇组合优于继承。组件不需要为所有变化准备参数,而是可以提供一个 Widget 插槽,让调用方决定局部结构。
例如,一个通用信息面板可能只负责外框、间距和阴影,具体内容由 child 提供。
dart
import 'package:flutter/material.dart';
class InfoPanel extends StatelessWidget {
final Widget child;
const InfoPanel({
super.key,
required this.child,
});
@override
Widget build(BuildContext context) {
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: child,
),
);
}
}预期输出
text
页面显示一个带卡片背景和内边距的内容区域。
具体内容由调用 InfoPanel 的位置决定。这里 InfoPanel 不关心里面是文本、图片还是表单,只负责公共布局。
使用 header 和 trailing 扩展业务组件
除了单一 child,业务组件经常需要多个插槽。例如列表项可能需要标题区域、右侧操作区域和主体内容。
可以通过命名 Widget 参数表达这些区域:
dart
class ProductTile extends StatelessWidget {
final Widget title;
final Widget? trailing;
const ProductTile({
super.key,
required this.title,
this.trailing,
});
@override
Widget build(BuildContext context) {
return ListTile(
title: title,
trailing: trailing,
);
}
}预期输出
text
列表项左侧显示传入的标题组件。
右侧显示传入的操作按钮或其他 Widget。命名插槽比大量字符串参数更灵活,因为调用方可以传入任意 Widget 树。
选择数据参数还是 Widget 参数
两者解决的问题不同:
| 方式 | 适合场景 | 示例 |
|---|---|---|
| 数据参数 | 内容固定但数据变化 | String title |
| Widget 参数 | 布局或视觉结构变化 | Widget trailing |
如果组件只需要展示文字,使用字符串参数更简单。如果需要允许调用方改变布局,应该提供 Widget 参数。
控制组合复杂度
Widget 插槽虽然灵活,但也可能让组件失去边界。设计时需要明确哪些区域属于组件责任,哪些区域交给调用方。
适合开放插槽的场景:
- 卡片内容区域经常变化。
- 操作按钮数量不同。
- 页面需要组合不同业务模块。
不适合开放插槽的场景:
- 组件内部结构完全固定。
- 外部传入内容会破坏统一交互规范。
合理使用 Widget 参数,可以让组件保持稳定外壳,同时允许业务页面自由组合内容。
按自己的节奏,确认真正理解。