Улучшить эту документацию Просмотреть исходный код ngInclude

директива в модуле ng

Загружает, компилирует и включает внешний фрагмент HTML.

По умолчанию URL шаблона ограничен тем же доменным именем и протоколом, что и документ приложения. Это делается путем вызова $sce.getTrustedResourceUrl для него. Чтобы загружать шаблоны с других доменов или протоколов, вы можете либо включить их в белый список, либо обработать их как надёжные значения. Обратитесь к жесткому контролю контекста Angular.

Кроме того, политика браузера Same Origin Policy и политика Cross-Origin Resource Sharing (CORS) могут дополнительно ограничивать успешную загрузку шаблона. Например, ngInclude не будет работать для запросов с разных доменов во всех браузерах и для file:// доступа в некоторых браузерах.

Информация о директиве

Эта директива создаёт новую область видимости.
Эта директива выполняется на уровне приоритета 400.

Использование

как элемент: (Эта директива может использоваться как пользовательский элемент, но имейте в виду ограничения IE).
```
<ng-include
  src=""
  [onload=""]
  [autoscroll=""]>
...
</ng-include>
```

как атрибут:

<ANY
  ng-include=""
  [onload=""]
  [autoscroll=""]>
...
</ANY>

как класс CSS:

<ANY class="ng-include: ; [onload: ;] [autoscroll: ;]"> ... </ANY>

Анимации

анимация enter используется для ввода нового содержимого в браузер. анимация leave используется для анимированного удаления существующего содержимого.

Анимации enter и leave происходят одновременно.

Нажмите здесь, чтобы узнать больше о шагах, участвующих в анимации.

Аргументы

Параметр Тип Подробности

ngInclude | src

Параметр	Тип	Подробности
ngInclude \| src	`string`	Выражение Angular, вычисляющее URL. Если источник является строковой константой, убедитесь, что вы заключили её в одинарные кавычки, например `src="'myPartialTemplate.html'"`.
onload (необязательно)	`string`	Выражение, вычисляемое при загрузке нового фрагмента.
autoscroll (необязательно)	`string`	Определяет, должен ли `ngInclude` вызвать $anchorScroll для прокрутки области просмотра после загрузки содержимого. - If the attribute is not set, disable scrolling. - If the attribute is set without value, enable scrolling. - Otherwise enable scrolling only if the expression evaluates to truthy value.

string

Выражение Angular, вычисляющее URL. Если источник является строковой константой, убедитесь, что вы заключили её в одинарные кавычки, например src="'myPartialTemplate.html'".

onload

(необязательно)

string

Выражение, вычисляемое при загрузке нового фрагмента.

autoscroll

(необязательно)

string

Определяет, должен ли ngInclude вызвать $anchorScroll для прокрутки области просмотра после загрузки содержимого.

- If the attribute is not set, disable scrolling.
- If the attribute is set without value, enable scrolling.
- Otherwise enable scrolling only if the expression evaluates to truthy value.

События

$includeContentRequested

Выдаётся каждый раз, когда запрашивается содержимое ngInclude.

Тип:

emit

Целевой объект:

область видимости, в которой был объявлен ngInclude

Параметры

Параметр	Тип	Подробности
angularEvent	`Object`	Синтетический объект события.
src	`String`	URL загружаемого содержимого.

$includeContentLoaded

Выдаётся каждый раз, когда содержимое ngInclude перезагружается.

Тип:

emit

Целевой объект:

текущая область видимости ngInclude

Параметры

Параметр	Тип	Подробности
angularEvent	`Object`	Синтетический объект события.
src	`String`	URL загружаемого содержимого.

$includeContentError

Выдаётся, когда HTTP-запрос шаблона возвращает ошибочный ответ (статус < 200 || статус > 299)

Тип:

emit

Целевой объект:

область видимости, в которой был объявлен ngInclude

Параметры

Параметр	Тип	Подробности
angularEvent	`Object`	Синтетический объект события.
src	`String`	URL загружаемого содержимого.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.3.20/docs/api/ng/directive/ngInclude