📚 课程目录第4章槽位Slot接口设计原则

槽位 Slot 接口设计原则：泛型约束、空安全、可组合性

边界与分层定位

槽位（Slot）接口是 Composable 组件树与可变内容插入点之间的契约边界。在架构分层中，Slot 接口位于“组件声明层”与“内容提供层”的中间地带：

上游：父 Composable 通过 Slot 接口传递 UI 片段（@Composable lambda）或数据状态。
下游：子 Composable 在布局的固定位置调用该 lambda，完成内容注入。
分层价值：Slot 接口隔离了“组件外壳”与“填充内容”的变更范围，使外壳可以独立演进，内容填充可以来自不同模块或业务方。

组件职责与泛型约束

Slot 接口的泛型参数决定了内容可携带的数据范围。典型设计有两种模式：

模式	泛型约束	典型接口	职责边界
纯 UI 槽位	`T : Any`（无约束）	`@Composable (T) -> Unit`	仅负责渲染，不关心数据来源
带状态槽位	`T : ViewModel` 或 `T : State`	`@Composable (T) -> Unit`	强制内容依赖特定状态类型
动作回调槽位	`T : (Event) -> Unit`	`(Action) -> Unit`	控制流由父组件驱动，子只负责调用

泛型约束的核心权衡：约束越强，接口语义越明确，但复用性降低；约束越弱，复用性高，但调用方需要自行处理类型转换与空安全。推荐在公共库中使用弱约束，在业务模块中使用强约束。

空安全与可组合性

Compose 中 Slot 参数通常定义为可空类型（T?），以便父组件可以选择不提供内容。空安全策略直接影响控制流：

控制流分支：若 Slot 为 null，组件必须跳过该位置的渲染，不可报错。典型写法：

@Composable
fun Card(
    title: @Composable (() -> Unit)? = null,
    content: @Composable () -> Unit
) {
    // ...
    if (title != null) {
        title()
    }
    content()
}

空安全带来的可组合性提升：消费者可以按需注入任意数量的槽位，组件无需预知所有填充场景。同时，Slot 的@Composable 类型天然支持嵌套重组，无需额外状态管理。

数据流与控制流

Slot 接口的数据流通常是单向向下：父组件通过 lambda 参数将数据传递给子组件，子组件仅渲染；控制流则通过动作回调槽位向上传递事件。典型数据流：

声明式数据流：父组件维护状态，每次重组时传入最新的 Slot 内容。
懒加载数据流：Slot 内容由子组件按需创建，如 LazyColumn 的 item 槽位。
双向数据流：通过回调槽位实现，例如 onValueChange: (String) -> Unit。

风险点：过度封装 Slot 接口可能导致组合爆炸。例如一个组件提供 5 个 Slot，每个 Slot 有 3 种可选内容，则使用方需要穷举 243 种排列组合。建议每个组件 Slot 数量控制在 3 个以内，并使用默认空值。

选型权衡矩阵

决策因素	推荐方案	备选方案	风险等级
泛型约束	使用 `reified T` 配合 `inline` 保留类型信息	非内联函数 + 类型擦除	中（性能损失）
空安全	所有可选 Slot 参数默认 `null`	使用 `EmptyView` 占位对象	低
可组合性	每个 Slot 独立为 `@Composable (T) -> Unit`	合并为单个 `@Composable ContentScope.() -> Unit`	高（使用方学习成本）
性能	避免在 Slot lambda 内直接计算耗时代码	使用 `remember` 缓存	低（需开发者自觉）

落地步骤

识别槽位点：分析当前组件中哪些位置可能被外部覆盖（标题、操作栏、底部浮层等）。
定义接口签名：为每个槽位创建 @Composable (Scope) -> Unit 类型的参数，Scope 携带该槽位的上下文数据。
设置空安全默认值：所有可选槽位参数赋予 null，并在渲染处做非空检查。
编写单元测试：验证槽位为 null 时组件不崩溃；验证多个槽位同时填充时的布局正确性。
文档化约束：在 KDoc 中注明每个 Slot 的泛型含义、空安全行为及常见使用示例。

验收标准

每个 Slot 参数都标注了明确的泛型类型（无 unsafeVariance 违规）。
组件不因 Slot 为 null 而产生 NPE 或布局异常。
同一个组件的多个 Slot 可以独立调用，不产生副作用冲突。
Slot 内可以安全读取外界 State 并进行重组，无需人工订阅。
消费者能够在不修改组件源码的情况下，替换任意位置的渲染内容。

📚 课程目录