AngularJS Директивы


AngularJS, с помощью так называемыхдирективновые атрибуты для расширения HTML.

AngularJS добавляет функциональность приложениям с помощью встроенных директив.

AngularJS позволяет определять пользовательские директивы.


Директивы AngularJS

Директивы AngularJS — это расширенные HTML-атрибуты с префиксом.ng-。

ng-appДиректива инициализирует приложение AngularJS.

ng-initДиректива инициализирует данные приложения.

ng-modelДиректива привязывает значения элементов (например, значение поля ввода) к приложению.

Для полного описания директив обратитесь кСправочному руководству по AngularJS。

Пример AngularJS

<div ng-app="" ng-init="firstName='John'"> <p>Попробуйте ввести в поле ввода:</p> <p>Имя:<input type="text" ng-model="firstName"></p> <p>Вы ввели: {{ firstName }}</p> </div>

Попробуйте сами »

ng-appДиректива сообщает AngularJS, что элемент <div> является 'владельцем'приложенияAngularJS.

Привязка данных

В приведенном выше примере выражение{{ firstName }}является выражением привязки данных AngularJS.

Привязка данных в AngularJS синхронизирует выражения AngularJS с данными AngularJS.

{{ firstName }}Именно черезng-model="firstName"выполняется синхронизация.

В следующем примере два текстовых поля синхронизируются с помощью двух директив ng-model:

Пример AngularJS

<div ng-app="" ng-init="quantity=1;price=5"> <h2>Калькулятор цены</h2>Количество:<input type="number" ng-model="quantity">Цена:<input type="number" ng-model="price"> <p><b>Итого:</b> {{ quantity * price }}</p> </div>

Попробуйте сами »

Note Использованиеng-initне очень распространено. Вы узнаете лучший способ инициализации данных в главе о контроллерах.

Повторяющиеся HTML-элементы

ng-repeatДиректива повторяет HTML-элемент:

Пример AngularJS

<div ng-app="" ng-init="names=['Jani','Hege','Kai']"> <p>Используйте ng-repeat для перебора массива</p> <ul> <li ng-repeat="x in names"> {{ x }} </li> </ul> </div>

Попробуйте сами »

ng-repeatДиректива используется для массива объектов:

Пример AngularJS

<div ng-app="" ng-init="names=[ {name:'Jani',country:'Norway'}, {name:'Hege',country:'Sweden'}, {name:'Kai',country:'Denmark'}]"> <p>Перебор объектов:</p> <ul> <li ng-repeat="x in names"> {{ x.name + ', ' + x.country }} </li> </ul> </div>

Попробуйте сами »

Note AngularJS прекрасно поддерживает приложения CRUD (создание, чтение, обновление, удаление) для баз данных.
Рассматривайте объекты в примере как записи в базе данных.

Директива ng-app

ng-appДиректива определяеткорневой элемент приложения AngularJS.。

ng-appДиректива, когда страница завершит загрузку,автоматически загрузит(автоматически инициализирует) приложение.

Позже вы узнаете,ng-appкак подключиться к кодовому модулю с помощью значения (например, ng-app="myModule").


Директива ng-init

ng-initДиректива определяет для приложения AngularJSначальные значения.。

Обычно ng-init не используется. Вместо него вы будете использовать контроллер или модуль.

Позже вы узнаете больше о контроллерах и модулях.


Директива ng-model

ng-modelДирективасвязывает HTML-элементыс данными приложения.

ng-modelДирективы также могут:

  • Обеспечивать проверку типов данных приложения (number, email, required).
  • Обеспечивать состояние данных приложения (invalid, dirty, touched, error).
  • Предоставлять CSS-классы для HTML-элементов.
  • Привязывать HTML-элементы к HTML-формам.

Директива ng-repeat

ng-repeatДля каждого элемента в коллекции (массиве) директива будетклонировать HTML-элемент один раз.。



Создание пользовательских директив

В дополнение к встроенным директивам AngularJS мы также можем создавать пользовательские директивы.

Вы можете использовать.directiveфункцию для добавления пользовательских директив.

Чтобы вызвать пользовательскую директиву, нужно добавить имя пользовательской директивы к HTML-элементу.

Используйте camelCase для именования директивы, exampleDirective, но при его использовании нужно-разделять его с помощью -,example-directive:

Пример AngularJS

<body ng-app="myApp">

<example-directive></example-directive>

<script>
var app = angular.module("myApp", []);
app.directive("exampleDirective", function() {
    return {
template : "<h1>Пользовательская директива!</h1>"
    };
});
</script>

</body>

Попробуйте сами »

Вы можете вызвать директиву следующими способами:

  • Имя элемента
  • Attribute
  • Имя класса
  • Комментарий

Следующие примеры также могут дать тот же результат:

Имя элемента

<example-directive></example-directive>

Попробуйте сами »

Attribute

<div example-directive></div>

Попробуйте сами »

Имя класса

<div class="example-directive"></div>

Попробуйте сами »

Комментарий

<!-- directive: example-directive -->

Попробуйте сами »

Ограничения использования

Вы можете ограничить свою директиву так, чтобы её можно было вызывать только определёнными методами.

Пример

Добавив атрибутrestrictи установив его значение в"A", чтобы настроить директиву так, чтобы её можно было вызывать только по атрибуту:

var app = angular.module("myApp", []);
app.directive("exampleDirective", function() {
    return {
        restrict : "A",
        template : "<h1>Пользовательская директива!</h1>"
    };
});

Попробуйте сами »

restrictЗначение может быть одним из следующих:

  • EИспользуется как имя элемента
  • AИспользуется как атрибут
  • CИспользуется как имя класса
  • MИспользуется как комментарий

restrictЗначение по умолчанию:EA, что означает, что директиву можно вызвать по имени элемента и имени атрибута.

Другие расширения