公开输入与输出
公开宿主指令的输入和输出
公开输入与输出 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。
公开组合后的 API
通过 hostDirectives 组合指令时，其输入和输出默认处于隐藏状态。组合 API 允许您将选定的输入和输出公开到宿主的公共 API 中。
对象形式
不要只列出类，而应使用包含 directive、inputs 和 outputs 数组的对象。
hostDirectives: [{
directive: TooltipDirective,
inputs: ['tooltipText'],
outputs: ['tooltipShown']
}]公开输入
将输入名称列在 inputs 中后，使用者就可以通过宿主元素绑定该输入。
<app-button tooltipText="Save changes"></app-button>公开输出
列出输出后，宿主就会重新发出该指令的事件。
<app-button (tooltipShown)="onShown()"></app-button>公开时重命名
使用 publicName: internalName 形式，可以在公开输入或输出时为其重命名。
inputs: ['tooltipText: hint']
// consumers bind [hint]="..."重命名输出
输出的重命名方式相同。
outputs: ['tooltipShown: shown']
// template: (shown)="..."为什么默认隐藏
隐藏组合后的输入和输出，可以让宿主的 API 保持明确且有意设计。您只公开使用者真正需要的内容，避免泄露内部指令的细节。
与自有输入组合
宿主可以同时拥有自己的输入和公开的输入；Angular 会将它们合并为元素上的单一公共 API。
@Component({
selector: 'app-button',
hostDirectives: [{
directive: TooltipDirective,
inputs: ['tooltipText']
}]
})
export class ButtonComponent {
label = input('');
}名称冲突
如果公开的输入名称与宿主自己的输入冲突，可以通过重命名来避免冲突并明确意图。
双向绑定
要通过组合支持双向绑定，请公开输入及其匹配的 Change 输出，并保持名称一致。
最佳实践
只公开使用者需要的最小且命名清晰的接口。请根据组件自身的术语为内部名称重命名，而不要照搬底层指令的名称。
快速检查
测试您对公开输入和输出的理解。
回顾
您了解到，hostDirectives 的对象形式可以将选定的 inputs 和 outputs 公开到宿主的 API 中，还可以使用 publicName: internalName 进行重命名，从而让公共接口保持明确且经过有意设计。
常见问题解答
「公开输入与输出」课时是免费的吗？
是的 — 「公开输入与输出」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Angular Academy 课程的其余内容，请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。
「公开输入与输出」这节课中我会学到什么？
公开宿主指令的输入和输出 你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Angular Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「公开输入与输出」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Angular Academy 课中编写并运行代码吗？
能。每节 Angular Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。