Spec-Zone.ru › Angular.js 1.2

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

  1. Директива в модуле 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. Если источник является строковой константой, убедитесь, что вы заключили его в одинарные кавычки, например, 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
  • $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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API