跨平台开发 / 系统课时

用 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 参数,可以让组件保持稳定外壳,同时允许业务页面自由组合内容。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Widget 参数支持内容插槽

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

登录哪都通