EmbeddedViewRef — Angular

Представляет представление Angular в контейнере представлений. На встроенное представление можно ссылаться из компонента, отличного от компонента-хоста, в шаблоне которого оно определено, или его можно определить независимо с помощью TemplateRef.

API

abstract class EmbeddedViewRef<C> extends ViewRef {
  abstract context: C;
  abstract readonly rootNodes: any[];
  abstract override destroy(): void;
  abstract override readonly destroyed: boolean;
  abstract override onDestroy(callback: Function): void;
  abstract override markForCheck(): void;
  abstract override detach(): void;
  abstract override detectChanges(): void;
  abstract override reattach(): void;
}

context

C

Контекст этого представления, унаследованный от якорного элемента.

rootNodes

any[]

Корневые узлы этого встроенного представления.

destroy

void

Уничтожает это представление и все связанные с ним структуры данных.

@returnsvoid

destroyed

boolean

Сообщает, было ли это представление уничтожено.

onDestroy

void

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

@paramcallbackFunction

Функция-обработчик, очищающая данные, связанные с представлением и определённые разработчиком. Вызывается при вызове метода destroy().

@returnsvoid

markForCheck

void

Если для представления используется стратегия обнаружения изменений ChangeDetectionStrategy#OnPush (checkOnce), явно помечает представление как изменённое, чтобы его можно было проверить повторно.

Обычно компоненты помечаются как требующие обновления (повторной отрисовки), если изменились входные данные или в представлении произошли события. Вызовите этот метод, чтобы компонент был проверен, даже если эти условия не выполнялись.

@returnsvoid

detach

void

Отсоединяет это представление от дерева обнаружения изменений. Отсоединённое представление не проверяется, пока его не присоединят снова. Используйте этот метод вместе с detectChanges() для реализации локальных проверок на обнаружение изменений.

Отсоединённые представления не проверяются во время циклов обнаружения изменений, пока их не присоединят снова, даже если они помечены как требующие обновления.

@returnsvoid

detectChanges

void

Проверяет это представление и его дочерние элементы. Используйте этот метод вместе с ChangeDetectorRef#detach для реализации локальных проверок на обнаружение изменений.

@returnsvoid

reattach

void

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

@returnsvoid

Описание

Свойства элементов в представлении могут изменяться, но структура представления (количество и порядок элементов) — нет. Изменяйте структуру элементов, вставляя, перемещая или удаляя вложенные представления в контейнере представлений.

Примечания по использованию

Следующий шаблон разбивается на два отдельных экземпляра TemplateRef: внешний и внутренний.

Count: {{items.length}}
<ul>
  <li *ngFor="let  item of items">{{item}}</li>
</ul>

Это внешний TemplateRef:

Count: {{items.length}}
<ul>
  <ng-template ngFor let-item [ngForOf]="items"></ng-template>
</ul>

Это внутренний TemplateRef:

  <li>{{item}}</li>

Внешний и внутренний экземпляры TemplateRef объединяются в представления следующим образом:

<!-- ViewRef: outer-0 -->
Count: 2
<ul>
  <ng-template view-container-ref></ng-template>
  <!-- ViewRef: inner-1 --><li>first</li><!-- /ViewRef: inner-1 -->
  <!-- ViewRef: inner-2 --><li>second</li><!-- /ViewRef: inner-2 -->
</ul>
<!-- /ViewRef: outer-0 -->