TemplateRef 与 ViewContainerRef
动态渲染模板
TemplateRef 与 ViewContainerRef 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。
命令式渲染
有时您必须以编程方式而不是声明方式渲染内容。Angular 提供 TemplateRef 和 ViewContainerRef 来实现这种底层控制。
TemplateRef
TemplateRef 是对 <ng-template> 的句柄，表示可以稍后实例化的标记。
tpl = viewChild.required<TemplateRef<unknown>>('tpl');ViewContainerRef
ViewContainerRef 是 DOM 中用于附加视图的位置。注入它即可控制该位置渲染的内容。
private vcr = inject(ViewContainerRef);createEmbeddedView
将两者结合起来：createEmbeddedView 会将 TemplateRef 实例化到 ViewContainerRef 中。
this.vcr.createEmbeddedView(this.tpl());传递上下文
您可以将上下文对象作为第二个参数传递，并通过 let- 变量访问它。
this.vcr.createEmbeddedView(this.tpl(), {
$implicit: 'Hello',
count: 3
});清除视图
ViewContainerRef.clear() 会移除它创建的所有视图。这就是切换动态内容显示与隐藏的方式。
this.vcr.clear();自定义结构型指令
自定义结构型指令正是基于这一模式实现的。该指令会注入这两个引用，并有条件地渲染内容。
@Directive({ selector: '[appUnless]' })
export class UnlessDirective {
private tpl = inject(TemplateRef<unknown>);
private vcr = inject(ViewContainerRef);
}响应输入
指令输入的 setter 会驱动 create/clear，使视图显示或消失。
@Input() set appUnless(condition: boolean) {
if (!condition) {
this.vcr.createEmbeddedView(this.tpl);
} else {
this.vcr.clear();
}
}插入到指定索引
createEmbeddedView 接受一个索引，用于控制视图在同级视图中的插入顺序。
this.vcr.createEmbeddedView(this.tpl(), {}, 0);createComponent
ViewContainerRef 还可以通过 createComponent 动态实例化组件，这是 ComponentFactoryResolver 的现代替代方案。
const ref = this.vcr.createComponent(WidgetComponent);
ref.setInput('title', 'Hi');清理资源
以命令式方式创建的视图必须进行清理。销毁宿主组件会自动清空其 ViewContainerRef，但在手动切换内容时，请调用 clear()。
快速检查
测试您对命令式渲染的理解。
回顾
您已学习到，TemplateRef 是模板标记的句柄，ViewContainerRef 是 DOM 插入点，而 createEmbeddedView 会将前者渲染到后者中。它们结合起来，可以实现自定义结构型指令和动态组件。
常见问题解答
「TemplateRef 与 ViewContainerRef」课时是免费的吗？
是的 — 「TemplateRef 与 ViewContainerRef」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Angular Academy 课程的其余内容，请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。
「TemplateRef 与 ViewContainerRef」这节课中我会学到什么？
动态渲染模板 你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Angular Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「TemplateRef 与 ViewContainerRef」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Angular Academy 课中编写并运行代码吗？
能。每节 Angular Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 单插槽内容投影
- 使用 select 进行多插槽投影
- ng-template 与 ng-container
- TemplateRef 与 ViewContainerRef