0Pricing
Angular Academy · 课时

hostDirectives 属性

将指令附加到组件宿主上

hostDirectives 属性 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 1 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。

指令组合 API

指令组合 API 允许组件或指令通过 hostDirectives 属性,以声明方式将其他指令应用到自身的宿主元素上。这样无需继承即可实现复用。

它解决的问题

以前,要复用指令行为,您要么在每个模板中重复使用该指令,要么使用继承。hostDirectives 可以直接将行为组合到宿主元素上。

基本语法

在组件元数据的 hostDirectives 数组中列出指令。

@Component({
  selector: 'app-menu',
  hostDirectives: [CdkTrapFocus],
  template: '<ng-content></ng-content>'
})
export class MenuComponent {}

运行结果

Angular 会自动将 CdkTrapFocus 应用到每个 app-menu 宿主元素。使用者无需自行添加该指令即可获得相应行为。

要求

宿主指令必须是独立的。您应直接引用指令类,而不是引用其选择器。

多个宿主指令

通过将多个行为全部列出,可以组合使用它们。

hostDirectives: [
  HighlightDirective,
  TooltipDirective,
  CdkTrapFocus
]

应用于指令

指令也可以拥有宿主指令,从而构建分层且可组合的行为。

@Directive({
  selector: '[appCard]',
  hostDirectives: [HoverElevateDirective]
})
export class CardDirective {}

生命周期顺序

宿主指令会在宿主自身的构造函数逻辑之前实例化,因此宿主初始化时即可使用它们的设置。

依赖注入

通过元素注入器,宿主指令可以注入到宿主中,反之亦然,从而实现组合行为之间的协调。

private trap = inject(CdkTrapFocus);

无需修改模板

最大的优势在于:app-menu 的使用者无需了解 CdkTrapFocus。该行为已封装在组件定义中。

适用场景

请使用 hostDirectives 将跨领域行为(焦点陷阱、波纹效果、分析)简洁且可复用地打包到组件或指令中。

快速检查

测试您对 hostDirectives 的理解。

回顾

您了解到,hostDirectives 属性会自动将独立指令应用到组件或指令的宿主元素上,从而无需模板或继承即可通过组合复用行为。

常见问题解答

「hostDirectives 属性」课时是免费的吗?

是的 — 「hostDirectives 属性」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Angular Academy 课程的其余内容,请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。

「hostDirectives 属性」这节课中我会学到什么?

将指令附加到组件宿主上 你通过在浏览器中直接运行的动手代码来练习 Angular Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Angular Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 1 节课,共 4 节。

「hostDirectives 属性」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Angular Academy 课中编写并运行代码吗?

能。每节 Angular Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. hostDirectives 属性
  2. 公开输入与输出
  3. 构建可复用行为
  4. 组合与继承
← 返回 Angular Academy