Шаблонные переменные, ViewChild и ContentChild

Шаблонные переменные позволяют определить некоторые переменные внутри шаблона компонента и затем ссылаться к этим переменным из этого же шаблона. Для определения подобных переменных применяется знак решетки (#). Например, определим шаблонную переменнуюuserName в компоненте:

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

@Component({
    selector: 'my-app',
    template: `
                <p #userName>{{name}}</p>
                <p>{{userName.textContent}}</p>
                <input type="text" [(ngModel)]="name" />`
})
export class AppComponent { 
    public name: string = "Tom";
}

Определение переменной выглядит следующим образом:

<p #userName>{{name}}</p>

Определение переменной userName в элементе параграфа означает, что она будет представлять данный параграф, то есть элемент p разметки html. И далее мы можем обращаться к этому параграфу через данную переменную. Например, через свойствоuserName.textContent можно получить текстовое содержимое параграфа. При этом, если привязанное к параграфу значение переменной name изменится, то соответственно изменится и значениеuserName.textContent. При этом данную переменную мы можем использовать только внутри шаблона.

Использование шаблонных переменных открывает нам дополнительный способ взаимодействия между родительским и дочерним компонентом. Например, определим следующий дочерний компонент ChildComponent:

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

@Component({
    selector: 'child-comp',
    template: `<p>{{counter}}</p>`
})
export class ChildComponent{

    public counter: number = 0;
    public increment() { this.counter++; }
    public decrement() { this.counter--; }
}

В этом компоненте определяется переменная счетчика counter. Для ее увеличения или уменьшения применяются методы increment и decrement.

В коде главного компонента будем вызывать дочерний компонент:

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

@Component({
    selector: 'my-app',
    template: `<child-comp #counter></child-comp>
                <button (click)="counter.increment()">+</button>
                <button (click)="counter.decrement()">-</button>`
})
export class AppComponent { }

В данном случае шаблонная переменнаяcounter, определенная внутри тега<child-comp>, поэтому она будет представлять компонент ChildComponent.

Соответственно далее мы можем ссылаться к компоненту ChildComponent через эту переменную, например, установить для событий кнопок привязку к методам ChildComponent. В итоге по нажатию на кнопки в главном компоненте будут вызываться методы из дочернего компонента.

ViewChild

Однако шаблонные переменные имеют свои ограничения: они не могут применяться вне шаблона, даже в коде класса компонента. Например, мы не можем написать так:

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

@Component({
    selector: 'my-app',
    template: `<child-comp #counter></child-comp>
                <button (click)="increment()">+</button>
                <button (click)="decrement()">-</button>`
})
export class AppComponent { 

    increment() { this.counter++; }
    decrement() { this.counter--; }
}

Здесь для класса AppComponent свойстваthis.counterне существует - оно существует только для шаблона.

Чтобы все таки иметь возможность обращаться к методам и прочей функциональности дочернего компонента, надо использовать декоратор ViewChild. Так, изменим главный компонент следующим образом:

import { Component, ViewChild } from '@angular/core';
import { ChildComponent} from './child.component';

@Component({
    selector: 'my-app',
    template: `<child-comp></child-comp>
                <button (click)="increment()">+</button>
                <button (click)="decrement()">-</button>`
})
export class AppComponent { 

    @ViewChild(ChildComponent)
    private counterComponent: ChildComponent;

    increment() { this.counterComponent.increment(); }
    decrement() { this.counterComponent.decrement(); }
}

С помощью применения к нему декоратораViewChildк свойствуcounterComponentмы устанавливаем, что это свойство будет содержать объект дочернего компонента, который внедряется через элемент<child-comp></child-comp>. И в этом случае мы уже можем не использовать шаблонные переменные в шаблоне.

Привязка ViewChild к шаблонным переменным

Несмотря на то, что выше мы не использовали переменные, тем не менее с помощью декоратора ViewChild также можно связать свойство и переменную из шаблона. Так, изменим код главного компонента:

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

@Component({
    selector: 'my-app',
    template: `<p #nameParagraph>{{name}}</p>
               <p>{{nameParagraph.textContent}}</p>
               <button (click)="change()">Изменить</button>`
})
export class AppComponent { 

    @ViewChild("nameParagraph")
    nameParagraph: ElementRef;

    name: string = "Tom";

    change() { 
        console.log(this.nameParagraph.nativeElement.textContent); 
        this.nameParagraph.nativeElement.textContent = "hell";
    }
}

Здесь в шаблоне определяется переменнаяnameParagraph, которая представляет код параграфа. А в декоратор ViewChild передается имя этой переменной. Поэтому свойство nameParagraph, к которому применяется декоратор, будет указывать на эту переменную.

По нажатию на кнопку выводится и изменяется текстовое содержимое этой переменной.

ContentChild

Кроме ViewChild для связи с шаблонными переменными мы можем применять другой декоратор - ContentChild. В какой ситуации он может понадобится? Допустим, в родительском компоненте определен следующий код:

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

@Component({
    selector: 'my-app',
    template: `<child-comp>
                    <h3 #headerContent>Добро пожаловать {{name}}!</h3>
               </child-comp>`
})
export class AppComponent { 

    name: string = "Tom";
}

Здесь определена переменная#headerContent, которая указывает на элемент заголовка h3.

Причем поскольку данные из родительского компонента передаются в дочерний напрямую, то для получения этих данных в дочернем компоненте будет использоваться элементng-content:

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

@Component({
    selector: 'child-comp',
    template: `<ng-content></ng-content>
               <button (click)="change()">Изменить</button>`
})
export class ChildComponent{ 

    @ContentChild("headerContent")
    header: ElementRef;

    change() { 
        console.log(this.header); 
        this.header.nativeElement.textContent = "Hell to world!"; 
    }
}

И как раз чтобы получить переменные, которые передаются с кодом через ng-content, дочерний компонент применяет декоратор ContentChild. В этот декоратор также передается название переменной. Само свойство декоратора также представляет объект HTMLElement. И далее мы можем манипулировать этим объектом.