Улучшить эту документацию Просмотреть исходный код ngInclude
- Директива в модуле ng
Загружает, компилирует и включает внешний фрагмент HTML.
По умолчанию URL шаблона ограничен тем же доменом и протоколом, что и документ приложения. Это делается с помощью вызова $sce.getTrustedResourceUrl на нем. Для загрузки шаблонов с других доменов или протоколов можно либо добавить их в белый список, либо упаковать их как доверенные значения. Обратитесь к жесткому ограничению контекстного экранирования Angular.
Кроме того, политика «одного происхождения» браузера и политика совместного использования ресурсов (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>
Анимации
анимация ввода используется для ввода нового содержимого в браузер. анимация выхода используется для анимации удаления существующего содержимого.
Анимации ввода и выхода происходят одновременно.
Нажмите здесь, чтобы узнать больше о шагах, участвующих в анимации.Аргументы
| Параметр | Тип | Подробности |
|---|---|---|
| ngInclude | src | string | выражение Angular, вычисляющее URL. Если источник является строковой константой, убедитесь, что вы заключили его в одинарные кавычки, например, |
| onload (необязательно) | string | Выражение для вычисления при загрузке новой части. |
| autoscroll (необязательно) | string | Определяет, следует ли - 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 -
$includeContentLoaded
Выдается каждый раз, когда содержимое ngInclude перезагружается.
Тип:
emitЦель:
текущей области видимости ngInclude
© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.2.32/docs/api/ng/directive/ngInclude