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

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

Обзор

Используйте эту директиву для автоматической инициализации приложения AngularJS. Директива ngApp обозначает корневой элемент приложения и обычно размещается рядом с корневым элементом страницы — например, на тегах <body> или <html>.

При использовании ngApp следует учитывать несколько моментов:

в одном HTML-документе может быть инициализировано только одно приложение AngularJS. Первая ngApp в документе будет использована для определения корневого элемента, который будет инициализирован как приложение. Для запуска нескольких приложений в одном HTML-документе необходимо вручную инициализировать их с помощью angular.bootstrap.
приложения AngularJS не могут быть вложены друг в друга.
Не используйте директиву, использующую транклюзию, в одном элементе с ngApp. Это относится к таким директивам, как ngIf, ngInclude и ngView. В этом случае происходит неправильное размещение корневого элемента приложения $rootElement и инжектора приложения, что приводит к остановке анимаций и недоступности инжектора извне приложения.

Можно указать модуль AngularJS, который будет использоваться как корневой модуль приложения. Этот модуль будет загружен в $injector при инициализации приложения. Он должен содержать необходимый код приложения или иметь зависимости от других модулей, которые содержат код. Дополнительную информацию см. в angular.module.

В примере ниже, если директива ngApp не была размещена на элементе html, то документ не был бы скомпилирован, AppController не был бы инициализирован, и {{ a+b }} не был бы решен в 3.

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

Эта директива выполняется на уровне приоритета 0.

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

как элемент:

<ng-app
  ng-app="angular.Module"
  [ng-strict-di="boolean"]>
...
</ng-app>

как атрибут:

<ANY
  ng-app="angular.Module"
  [ng-strict-di="boolean"]>
...
</ANY>

Аргументы

Параметр	Тип	Описание
ngApp	`angular.Module`	необязательное имя модуля приложения модуль для загрузки.
ngStrictDi (необязательно)	`boolean`	если этот атрибут присутствует в элементе приложения, инжектор будет создан в режиме «strict-di». Это означает, что приложение не сможет вызывать функции, не использующие явное аннотирование функций (и поэтому не подходящие для минификации), как описано в руководстве по инъекции зависимостей, и полезные сведения об отладке помогут отследить причину этих ошибок.

Примеры

Простое использование

ngApp — самый простой и распространённый способ инициализации приложения.

С ngStrictDi

Используя ngStrictDi, вы увидите что-то вроде этого:

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