问题描述
我使用如下代码测试一个最简单的 Angular 内容投影场景:
import { Component } from '@angular/core';
@Component({
selector: 'app-zippy-basic',
template: `
Single-slot content projection
`
})
export class ZippyBasicComponent {}

我期望
app-zippy-basic 的使用者,将传入的
content,投射到元素
ng-container 内部。
消费代码如下图所示:
Is content projection cool?
ok
然而运行时,我在渲染出的页面里,根本看不到
Is content projection cool? 的显示。

问题分析
打开 Chrome 开发者工具,发现
app-zippy-basic 内部只有一个 comment 节点:ng-container

我们在提供内容投影插槽的 Component 的 ng-container 之间随便键入一些字符串,例如 DIV:

渲染后发现,ng-container 没能按照我们期望的工作。

通过查阅 Angular 官网,发现这里把 ng-container 和 ng-content 弄混淆了。此处应该使用 ng-content.
解决方案
ng-content 之间不允许再插入其他元素。仅仅充当一个占位符的角色。

使用
ng-content 之后问题消失。这里我们可以通过单步调试的方式,搞清楚被投影的内容是如何插入到 ng-content 占位符里的。

选择
app-zippy-basic,给其设置一个 dom 断点,类型为
subtree modification:

首先执行 template 函数,将 Component 本身的 h2 元素,进行 HTML 源代码的渲染:


接下来是 Angular 处理整个内容投影逻辑的关键:

遇到
ng-content,则调用函数
ɵɵprojection:

转而调用
applyProjection:

parent node 即是指定义了
ng-content 的 Component 对应的 dom 元素:

rNode 即是被插入到
app-zippy-basic 中的节点,即
app-zippy-basic 的消费者。

消费语法:
此处插入你想投影到 app-zippy-basic 内部的 HTML 源代码