Angular 内容投影 content projection 的一个问题的单步调试

问题描述

我使用如下代码测试一个最简单的 Angular 内容投影场景：

import { Component } from '@angular/core';

@Component({
  selector: 'app-zippy-basic',
  template: `
    <h2>Single-slot content projection</h2>
    <ng-container></ng-container>
  `
})
export class ZippyBasicComponent {}

我期望 app-zippy-basic 的使用者，将传入的 content，投射到元素 ng-container 内部。

消费代码如下图所示：

<app-zippy-basic>
    <p>Is content projection cool?</p>
    <div>ok</div>
</app-zippy-basic>

然而运行时，我在渲染出的页面里，根本看不到 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>
此处插入你想投影到 app-zippy-basic 内部的 HTML 源代码
</app-zippy-basic>