この記事では、Angular 開発の実践 (3): Angular コンポーネントの分析を紹介します。興味のある方はご覧ください

Web コンポーネント

Angular コンポーネントを紹介する前に、W3C Web コンポーネントについて簡単に理解しましょう

定義

W3C は統一コンポーネント標準方式を策定し、Webコンポーネントの標準を提案します。
各コンポーネントには、独自の html、css、および js コードが含まれています。
Web コンポーネント標準には、次の 4 つの重要な概念が含まれています。

カスタム要素 (カスタムタグ): カスタム HTML タグと要素を作成できます。
HTML テンプレート (HTML テンプレート): <template> タグで一部のコンテンツを事前定義しますが、ページには読み込まれませんが、JS コードを使用して初期化されます。 <template> 标签去预定义一些内容，但并不加载至页面，而是使用 JS 代码去初始化它；
Shadow DOM（虚拟DOM）：可以创建完全独立与其他元素的DOM子树；
HTML Imports（HTML导入）：一种在 HTML 文档中引入其他 HTML 文档的方法，<link rel="import" href="example.html" />。

概括来说就是，可以创建自定义标签来引入组件是前端组件化的基础，在页面引用 HTML 文件和 HTML 模板是用于支撑编写组件视图和组件资源管理，而 Shadow DOM 则是隔离组件间代码的冲突和影响。

示例

定义hello-component

<template id="hello-template">
    <style>
        h1 {
            color: red;
        }
    </style>
    <h1>Hello Web Component!</h1>
</template>

<script>

    // 指向导入文档，即本例的index.html
    var indexDoc = document;

    // 指向被导入文档，即当前文档hello.html
    var helloDoc = (indexDoc._currentScript || indexDoc.currentScript).ownerDocument;

    // 获得上面的模板
    var tmpl = helloDoc.querySelector('#hello-template');

    // 创建一个新元素的原型，继承自HTMLElement
    var HelloProto = Object.create(HTMLElement.prototype);

    // 设置 Shadow DOM 并将模板的内容克隆进去
    HelloProto.createdCallback = function() {
        var root = this.createShadowRoot();
        root.appendChild(indexDoc.importNode(tmpl.content, true));
    };

    // 注册新元素
    var hello = indexDoc.registerElement('hello-component', {
        prototype: HelloProto
    });
</script>

ログイン後にコピー

使用hello-component

<!DOCTYPE html>
<html lang="zh-cn">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-COMPATIBLE" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="author" content="赖祥燃, laixiangran@163.com, http://www.laixiangran.cn"/>
    <title>Web Component</title>
    <!--导入自定义组件-->
    <link rel="import" href="hello.html">
</head>
<body>
    <!--自定义标签-->
    <hello-component></hello-component>
</body>
</html>

ログイン後にコピー

从以上代码可看到，hello.html 为按标准定义的组件（名称为 hello-component ），在这个组件中有自己的结构、样式及逻辑，然后在 index.html 中引入该组件文件，即可像普通标签一样使用。

Angular Component

Angular Component属于指令的一种，可以理解为拥有模板的指令。其它两种是属性型指令和结构型指令。

基本组成

@Component({
    selector: 'demo-component',
    template: 'Demo Component'
})
export class DemoComponent {}

ログイン後にコピー

组件装饰器：每个组件类必须用@component进行装饰才能成为Angular组件。
组件元数据：组件元数据：selector、template等，下文将着重讲解每个元数据的含义。
组件类：组件实际上也是一个普通的类，组件的逻辑都在组件类里定义并实现。
组件模板：每个组件都会关联一个模板，这个模板最终会渲染到页面上，页面上这个DOM元素就是此组件实例的宿主元素。

组件元数据

自身元数据属性

Shadow DOM (仮想 DOM): 完全に独立した、他の要素の DOM サブツリー

名称	类型	作用
animations	`AnimationEntryMetadata[]`	设置组件的动画
changeDetection	`ChangeDetectionStrategy`	设置组件的变化监测策略
encapsulation	`ViewEncapsulation`	设置组件的视图包装选项
entryComponents	`any[]`	设置将被动态插入到该组件视图中的组件列表
interpolation	`[string, string]`	自定义组件的插值标记，默认是双大括号`{{}}`
moduleId	`string`	设置该组件在 ES/CommonJS 规范下的模块id，它被用于解析模板样式的相对路径
styleUrls	`string[]`	设置组件引用的外部样式文件
styles	`string[]`	设置组件使用的内联样式
template	`string`	设置组件的内联模板
templateUrl	`string`	设置组件模板所在路径
viewProviders	`Provider[]`

🎜HTML インポート: 他の HTML ドキュメントを HTML ドキュメントに導入する方法、<link rel="import" href="example.html" / >。 🎜🎜🎜 要約すると、コンポーネントを導入するカスタムタグを作成する機能は、ページ上の HTML ファイルと HTML テンプレートへの参照を使用して、コンポーネントビューとコンポーネントリソース管理の作成をサポートします。および Shadow DOM コンポーネント間のコードの競合と影響を分離するためのものです。 🎜🎜例🎜🎜 hello-component を定義する🎜

@Component({
    selector: 'demo-component',
    inputs: ['param']
})
export class DemoComponent {
    param: any;
}

ログイン後にコピー

🎜 hello-component を使用する🎜

@Component({
    selector: 'demo-component'
})
export class DemoComponent {
    @Input() param: any;
}

ログイン後にコピー

🎜 上記のコードからわかるように、hello.html は標準で定義されたコンポーネント (hello-component という名前) であり、このコンポーネントには独自の構造、スタイル、ロジックを作成し、index.html にコンポーネントファイルを導入して、通常のタグと同様に使用します。 🎜🎜Angular コンポーネント🎜🎜Angular コンポーネントはディレクティブの一種であり、テンプレートを備えたディレクティブとして理解できます。他の 2 つのタイプは、属性ディレクティブと構造ディレクティブです。 🎜🎜基本的な構成🎜

@Component({
    selector: 'demo-component',
    outputs: ['ready']
})
export class DemoComponent {
    ready = new eventEmitter<false>();
}

ログイン後にコピー

🎜🎜🎜コンポーネントデコレータ: Angular コンポーネントになるには、各コンポーネントクラスを @component で修飾する必要があります。 🎜🎜🎜🎜コンポーネントのメタデータ: コンポーネントのメタデータ: selector、template など。以下では、各メタデータの意味に焦点を当てます。 🎜🎜🎜🎜コンポーネントクラス: コンポーネントは実際には通常のクラスであり、コンポーネントのロジックはコンポーネントクラスで定義および実装されます。 🎜🎜🎜🎜コンポーネントテンプレート: 各コンポーネントはテンプレートに関連付けられており、ページ上の DOM 要素は、このコンポーネントインスタンスのホスト要素です。 🎜🎜🎜🎜コンポーネントメタデータ🎜

セルフメタデータ属性

Function🎜🎜animations🎜🎜AnimationEntryMetadata[]🎜🎜コンポーネントのアニメーションを設定します🎜🎜🎜changeDetection🎜🎜 ChangeDetectionStrategy🎜🎜コンポーネントの変更検出戦略を設定します🎜🎜🎜encapsulation🎜🎜ViewEncapsulation🎜🎜コンポーネントのビューパッケージ化オプションを設定します🎜🎜🎜entryComponents🎜🎜 any[]🎜🎜このコンポーネントビューに動的に挿入されるコンポーネントのリストを設定します🎜🎜🎜interpolation🎜🎜[string, string]🎜🎜カスタムコンポーネントの補間タグ、デフォルトは二重中括弧です {{}}🎜🎜🎜moduleId🎜🎜string🎜🎜 ES/CommonJS の下のコンポーネントのモジュール ID を設定します仕様、テンプレートスタイルへの相対パスを解決するために使用されます🎜🎜🎜styleUrls🎜🎜string[]🎜🎜コンポーネントによって参照される外部スタイルファイルを設定します🎜🎜🎜styles🎜🎜 string[]🎜🎜コンポーネントで使用されるインラインスタイルを設定します🎜🎜🎜template🎜🎜string🎜🎜コンポーネントのインラインテンプレートを設定します🎜🎜 🎜templateUrl🎜🎜 string🎜🎜コンポーネントテンプレートが配置されているパスを設定します🎜🎜🎜viewProviders🎜🎜Provider[]🎜🎜コンポーネントとそのすべてを設定しますサブコンポーネント (ContentChildren を除く) が利用可能 Service🎜🎜🎜🎜

从 core/Directive 继承

名前	タイプ

名称	类型	作用
exportAs	`string`	设置组件实例在模板中的别名，使得可以在模板中调用
host	`{[key: string]: string}`	设置组件的事件、动作和属性等
inputs	`string[]`	设置组件的输入属性
outputs	`string[]`	设置组件的输出属性
providers	`Provider[]`	设置组件及其所有子组件（含ContentChildren）可用的服务（依赖注入）
queries	`{[key: string]: any}`	设置需要被注入到组件的查询
selector	`string`	设置用于在模板中识别该组件的css选择器（组件的自定义标签）

几种元数据详解

以下几种元数据的等价写法会比元数据设置更简洁易懂，所以一般推荐的是等价写法。

inputs

@Component({
    selector: 'demo-component',
    inputs: ['param']
})
export class DemoComponent {
    param: any;
}

ログイン後にコピー

等价于：

@Component({
    selector: 'demo-component'
})
export class DemoComponent {
    @Input() param: any;
}

ログイン後にコピー

outputs

@Component({
    selector: 'demo-component',
    outputs: ['ready']
})
export class DemoComponent {
    ready = new eventEmitter<false>();
}

ログイン後にコピー

等价于：

@Component({
    selector: 'demo-component'
})
export class DemoComponent {
    @Output() ready = new eventEmitter<false>();
}

ログイン後にコピー

host

@Component({
    selector: 'demo-component',
    host: {
        '(click)': 'onClick($event.target)', // 事件
        'role': 'nav', // 属性
        '[class.pressed]': 'isPressed', // 类
    }
})
export class DemoComponent {
    isPressed: boolean = true;

    onClick(elem: HTMLElement) {
        console.log(elem);
    }
}

ログイン後にコピー

等价于：

@Component({
    selector: &#39;demo-component&#39;
})
export class DemoComponent {
    @HostBinding(&#39;attr.role&#39;) role = &#39;nav&#39;;
    @HostBinding(&#39;class.pressed&#39;) isPressed: boolean = true;

    @HostListener(&#39;click&#39;, [&#39;$event.target&#39;])
    onClick(elem: HTMLElement) {
        console.log(elem);
    }
}

ログイン後にコピー

queries - 视图查询

@Component({
    selector: &#39;demo-component&#39;,
    template: `
        <input #theInput type=&#39;text&#39; />
        <p>Demo Component</p>
    `,
    queries: {
        theInput: new ViewChild(&#39;theInput&#39;)
    }
})
export class DemoComponent {
    theInput: ElementRef;
}

ログイン後にコピー

等价于：

@Component({
    selector: &#39;demo-component&#39;,
    template: `
        <input #theInput type=&#39;text&#39; />
        <p>Demo Component</p>
    `
})
export class DemoComponent {
    @ViewChild(&#39;theInput&#39;) theInput: ElementRef;
}

ログイン後にコピー

queries - 内容查询

<my-list>
    <li *ngFor="let item of items;">{{item}}</li>
</my-list>

ログイン後にコピー

@Directive({
    selector: &#39;li&#39;
})
export class ListItem {}

ログイン後にコピー

@Component({
    selector: &#39;my-list&#39;,
    template: `
        <ul>
            <ng-content></ng-content>
        </ul>
    `,
    queries: {
        items: new ContentChild(ListItem)
    }
})
export class MyListComponent {
    items: QueryList<ListItem>;
}

ログイン後にコピー

等价于：

@Component({
    selector: &#39;my-list&#39;,
    template: `
        <ul>
            <ng-content></ng-content>
        </ul>
    `
})
export class MyListComponent {
    @ContentChild(ListItem) items: QueryList<ListItem>;
}

ログイン後にコピー

styleUrls、styles

styleUrls和styles允许同时指定。
优先级：模板内联样式 > styleUrls > styles。
建议：使用styleUrls引用外部样式表文件，这样代码结构相比styles更清晰、更易于管理。同理，模板推荐使用templateUrl引用模板文件。

changeDetection

ChangeDetectionStrategy.Default：组件的每次变化监测都会检查其内部的所有数据（引用对象也会深度遍历），以此得到前后的数据变化。
ChangeDetectionStrategy.OnPush：组件的变化监测只检查输入属性（即@Input修饰的变量）的值是否发生变化，当这个值为引用类型（Object，Array等）时，则只对比该值的引用。
显然，OnPush策略相比Default降低了变化监测的复杂度，很好地提升了变化监测的性能。如果组件的更新只依赖输入属性的值，那么在该组件上使用OnPush策略是一个很好的选择。

encapsulation

ViewEncapsulation.None：无 Shadow DOM，并且也无样式包装。
ViewEncapsulation.Emulated：无 Shadow DOM，但是通过Angular提供的样式包装机制来模拟组件的独立性，使得组件的样式不受外部影响，这是Angular的默认设置。
ViewEncapsulation.Native：使用原生的 Shadow DOM 特性。

生命周期

当Angular使用构造函数新建组件后，就会按下面的顺序在特定时刻调用这些生命周期钩子方法：

生命周期钩子	调用时机
ngOnChanges	在ngOnInit之前调用，或者当组件输入数据（通过`@Input`装饰器显式指定的那些变量）变化时调用。
ngOnInit	第一次ngOnChanges之后调用。建议此时获取数据，不要在构造函数中获取。
ngDoCheck	每次变化监测发生时被调用。
ngAfterContentInit	使用将外部内容嵌入到组件视图后被调用，第一次ngDoCheck之后调用且只执行一次（只适用组件）。
ngAfterContentChecked	ngAfterContentInit后被调用，或者每次变化监测发生时被调用（只适用组件）。
ngAfterViewInit	创建了组件的视图及其子视图之后被调用（只适用组件）。
ngAfterViewChecked	ngAfterViewInit，或者每次子组件变化监测时被调用（只适用组件）。
ngOnDestroy	销毁指令/组件之前触发。此时应将不会被垃圾回收器自动回收的资源（比如已订阅的观察者事件、绑定过的DOM事件、通过setTimeout或setInterval设置过的计时器等等）手动销毁掉。