Angular開發實踐（八）：使用ng-content進行組件內容投射

在Angular中，組件屬於特殊的指令，它的特殊之處在於它有自己的模板（html）和樣式（css）。因此使用組件可以使我們的代碼具有強解耦、可復用、易擴展等特性。通常的組件定義如下： demo.component.ts： demo.component.html： demo.component.scs ...

在Angular中，組件屬於特殊的指令，它的特殊之處在於它有自己的模板（html）和樣式（css）。因此使用組件可以使我們的代碼具有強解耦、可復用、易擴展等特性。通常的組件定義如下：

demo.component.ts：

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

@Component({
    selector: 'demo-component',
    templateUrl: './demo.component.html',
    styleUrls: ['./demo.component.scss']
})
export class DemoComponent implements OnInit {

    constructor() {
    }

    ngOnInit() {
    }
}

demo.component.html：

<div class="demo">
    <h2>
        demo-component - 我是一個簡單的組件
    </h2>
</div>

demo.component.scss：

.demo {
    padding: 10px;
    border: 2px solid red;

    h2 {
        margin: 0;
        color: #262626;
    }
}

此時我們引用該組件，就會呈現該組件解析之後的內容：

<demo-component></demo-component>

假設現在有這樣的需求，這個組件能夠接受外部投射進來的內容，也就是說組件最終呈現的內容不僅僅是本身定義的那些，那該怎麼做呢？這時就要請出本文的主角 ng-content。

簡單投射

我們先從最簡單開始，在 demo.component.html 中添加，修改後的 demo.component.html 和 demo.component.scss 如下：

demo.component.html：

<div class="demo">
    <h2>
        demo-component - 可嵌入外部內容的組件
    </h2>
    <div class="content">
        <ng-content></ng-content>
    </div>
</div>

demo.component.scss：

.demo {
    padding: 10px;
    border: 2px solid red;

    h2 {
        margin: 0;
        color: #262626;
    }

    .content {
        padding: 10px;
        margin-top: 10px;
        line-height: 20px;
        color: #FFFFFF;
        background-color: #de7d28;
    }
}

為了效果展示特意將所在的容器背景色定義為橙色。

這時我們在引用該組件時可以從外部投射內容，外部內容將在橙色區域顯示：

<demo-component>
    我是外部嵌入的內容
</demo-component>

針對性投射

如果同時存在幾個，那外部內容將如何進行投射呢？

我們先看個示例，為了區別，我再新增一個藍色區域的，修改後的 demo.component.html 和 demo.component.scss 如下：

demo.component.html：

<div class="demo">
    <h2>
        demo-component - 可嵌入外部內容的組件
    </h2>
    <div class="content">
        <ng-content></ng-content>
    </div>
    <div class="content blue">
        <ng-content></ng-content>
    </div>
</div>

demo.component.scss：

.demo {
    padding: 10px;
    border: 2px solid red;

    h2 {
        margin: 0;
        color: #262626;
    }

    .content {
        padding: 10px;
        margin-top: 10px;
        line-height: 20px;
        color: #FFFFFF;
        background-color: #de7d28;
        
        &.blue {
            background-color: blue;
        }
    }
}

引用該組件：

<demo-component>
    我是外部嵌入的內容
</demo-component>

此時，我們將看到外部內容投射到了藍色區域：

當然，如果你將橙色區域代碼放在藍色區域代碼的後面，那麼外部內容就會投射到橙色區域：

所以從上面的示例我們可以看出，如果同時存在簡單的，那麼外部內容將投射在組件模板最後的那個中。

那麼知道這個問題，我們可能會想，能不能將外部內容有針對性的投射相應的中呢？答案顯然是可以的。

為了處理這個問題，

直接看例子，修改後的 demo.component.html 和 demo.component.scss 如下：

demo.component.html：

<div class="demo">
    <h2>
        demo-component - 可嵌入外部內容的組件
    </h2>
    <div class="content">
        <ng-content></ng-content>
    </div>
    <div class="content blue">
        <ng-content select="header"></ng-content>
    </div>
    <div class="content red">
        <ng-content select=".demo2"></ng-content>
    </div>
    <div class="content green">
        <ng-content select="[name=demo3]"></ng-content>
    </div>
</div>

demo.component.scss：

.demo {
    padding: 10px;
    border: 2px solid red;

    h2 {
        margin: 0;
        color: #262626;
    }

    .content {
        padding: 10px;
        margin-top: 10px;
        line-height: 20px;
        color: #FFFFFF;
        background-color: #de7d28;

        &.blue {
            background-color: blue;
        }

        &.red {
            background-color: red;
        }

        &.green {
            background-color: green;
        }
    }
}

從上面代碼可以看到，藍色區域將接收 標簽 header 那部分內容，紅色區域將接收 class為"demo2"的div 的那部分內容，綠色區域將接收 屬性name為"demo3"的div 的那部分內容，橙色區域將接收其餘的外部內容（開始，我是外部嵌入的內容，結束）。

引用該組件：

<demo-component>
    開始，我是外部嵌入的內容，
    <header>
        我是外部嵌入的內容，我在header中
    </header>
    <div class="demo2">
        我是外部嵌入的內容，我所在div的class為"demo2"
    </div>
    <div name="demo3">
        我是外部嵌入的內容demo，我所在div的屬性name為"demo3"
    </div>
    結束
</demo-component>

此時，我們將看到外部內容投射到了指定的中。

擴展知識

ngProjectAs

現在我們知道通過 ng-content 的 select 屬性可以指定外部內容投射到指定的中。

而要能正確的根據 select 屬性投射內容，有個限制就是 - 不管是 標簽 header、class為"demo2"的div還是 屬性name為"demo3"的div，這幾個標簽都是作為組件標簽的直接子節點。

那如果不是作為直接子節點，會是什麼情況呢？我們簡單修改下引用 demo-component 組件的代碼，將 標簽header 放在一個div中，修改如下：

<demo-component>
    開始，我是外部嵌入的內容，
    <div>
        <header>
            我是外部嵌入的內容，我在header中
        </header>
    </div>
    <div class="demo2">
        我是外部嵌入的內容，我所在div的class為"demo2"
    </div>
    <div name="demo3">
        我是外部嵌入的內容demo，我所在div的屬性name為"demo3"
    </div>
    結束
</demo-component>

此時，我們看到 標簽 header 那部分內容不再投射到藍色區域中了，而是投射到橙色區域中了。原因就是 <ng-content select="header"></ng-content> 無法匹配到之前的 標簽 header，故而將這部分內容投射到了橙色區域的 <ng-content></ng-content> 中了。

為瞭解決這個問題，我們必須使用 ngProjectAs 屬性，它可以應用於任何元素上。具體如下：

<demo-component>
    開始，我是外部嵌入的內容，
    <div ngProjectAs="header">
        <header>
            我是外部嵌入的內容，我在header中
        </header>
    </div>
    <div class="demo2">
        我是外部嵌入的內容，我所在div的class為"demo2"
    </div>
    <div name="demo3">
        我是外部嵌入的內容demo，我所在div的屬性name為"demo3"
    </div>
    結束
</demo-component>

通過設置 ngProjectAs 屬性，讓 標簽header 所在的 div 指向了 select="header"，此時 標簽 header 那部分內容有投射到藍色區域了：

`<ng-content>` 不“產生”內容

做個試驗

做個試驗，先定義一個 demo-child-component 組件：

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

@Component({
    selector: 'demo-child-component',
    template: '<h3>我是demo-child-component組件</h3>'
})
export class DemoChildComponent implements OnInit {

    constructor() {
    }

    ngOnInit() {
        console.log('demo-child-component初始化完成！');
    }
}

demo-component 組件修改為：

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

@Component({
    selector: 'demo-component',
    template: `
        <button (click)="show = !show">
            {{ show ? 'Hide' : 'Show' }}
        </button>
        <div class="content" *ngIf="show">
            <ng-content></ng-content>
        </div>
    `
})
export class DemoComponent implements OnInit {
    show = true;

    constructor() {
    }

    ngOnInit() {
    }
}

然後在 demo-component 中投射 demo-child-component：

<demo-component>
    <demo-child-component></demo-child-component>
</demo-component>

此時，在控制台我們看到列印出 demo-child-component初始化完成！ 這些文字。但是當我們點擊按鈕進行切換操作時，demo-child-component初始化完成！ 就不再列印了，這意味著我們的 demo-child-component 組件只被實例化了一次 - 從未被銷毀和重新創建。

為什麼會出現這樣的情況呢？

出現原因

<ng-content> 不會 "產生" 內容，它只是投影現有的內容。你可以認為它等價於 node.appendChild(el) 或 jQuery 中的 $(node).append(el) 方法：使用這些方法，節點不被克隆，它被簡單地移動到它的新位置。因此，投影內容的生命周期將被綁定到它被聲明的地方，而不是顯示在地方。

這也從原理解釋了前面那個問題：如果同時存在幾個，那外部內容將如何進行投射呢？

這種行為有兩個原因：期望一致性和性能。什麼 "期望的一致性" 意味著作為開發人員，可以基於應用程式的代碼，猜測其行為。假設我寫了以下代碼：

<demo-component>
    <demo-child-component></demo-child-component>
</demo-component>

很顯然 demo-child-component 組件將被實例化一次，但現在假如我們使用第三方庫的組件：

<third-party-wrapper>
    <demo-child-component></demo-child-component>
</third-party-wrapper>

如果第三方庫能夠控制 demo-child-component 組件的生命周期，我將無法知道它被實例化了多少次。其中唯一方法就是查看第三方庫的代碼，瞭解它們的內部處理邏輯。將組件的生命周期被綁定到我們的應用程式組件而不是包裝器的意義是，開發者可以掌控計數器只被實例化一次，而不用瞭解第三方庫的內部代碼。

性能的原因 更為重要。因為 ng-content 只是移動元素，所以可以在編譯時完成，而不是在運行時，這大大減少了實際應用程式的工作量。

解決方法

為了讓組件能夠控制投射進來的子組件的實例化，我們可以通過兩種方式完成：在我們的內容周圍使用 <ng-template> 元素及 ngTemplateOutlet，或者使用帶有 "*" 語法的結構指令。為簡單起見，我們將在示例中使用 <ng-template> 語法。

demo-component 組件修改為：

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

@Component({
    selector: 'demo-component',
    template: `
        <button (click)="show = !show">
            {{ show ? 'Hide' : 'Show' }}
        </button>
        <div class="content" *ngIf="show">
            <ng-container [ngTemplateOutlet]="template"></ng-container>
        </div>
    `
})
export class DemoComponent implements OnInit {
    @ContentChild(TemplateRef) template: TemplateRef;
    show = true;

    constructor() {
    }

    ngOnInit() {
    }
}

然後我們將 demo-child-component 包含在 ng-template 中：

<demo-component>
    <ng-template>
        <demo-child-component></demo-child-component>
    </ng-template>
</demo-component>

此時，我們在點擊按鈕進行切換操作時，控制台都會列印出 demo-child-component初始化完成！ 這些文字。

參考資源

ng-content: The hidden docs

Angular開發實踐（八）： 使用ng-content進行組件內容投射

簡單投射

針對性投射

擴展知識

ngProjectAs

<ng-content> 不“產生”內容

做個試驗

出現原因

解決方法

參考資源

Angular開發實踐（八）：使用ng-content進行組件內容投射

`<ng-content>` 不“產生”內容