Spec-Zone.ru › Angular.js 1.4

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

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

Атрибут ngOptions может использоваться для динамического создания списка элементов <option> для элемента <select>, используя массив или объект, полученный путём оценки выражения ngOptions.

Во многих случаях ngRepeat можно использовать на элементах <option> вместо ngOptions, чтобы получить похожий результат. Однако ngOptions имеет некоторые преимущества, такие как уменьшение использования памяти и увеличение скорости, не создавая новый контекст для каждого повторяющегося элемента, а также предоставляя больше гибкости в том, как модель <select> назначается через часть выражения select as. ngOptions следует использовать, когда модель <select> должна быть связана со значением, отличным от строки. Это связано с тем, что элемент option в настоящее время может быть связан только со строковыми значениями.

При выборе элемента в меню <select>, элемент массива или свойство объекта, представленные выбранным option, будут связаны с моделью, определённой директивой ngModel.

Необязательно, можно вложить один жёстко заданный элемент <option>, со значением, установленным в пустую строку, в элемент <select>. Этот элемент будет представлять элемент null или вариант «не выбран». Обратитесь к примеру ниже для демонстрации.

Сложные модели (объекты или коллекции)

По умолчанию ngModel отслеживает модель по ссылке, а не по значению. Это важно знать при привязке select к модели, которая является объектом или коллекцией.

Возникает проблема, если вы хотите предварительно выбрать вариант. Например, если вы зададите модель объекту, равному объекту в вашей коллекции, ngOptions не сможет установить выбор, потому что объекты не идентичны. Поэтому по умолчанию всегда следует ссылаться на элемент в вашей коллекции для предварительного выбора, например: $scope.selected = $scope.collection[3].

Другим решением является использование track by фрагмента, поскольку тогда ngOptions будет отслеживать идентичность элемента не по ссылке, а по результату выражения track by. Например, если элементы вашей коллекции имеют свойство id, вы бы track by item.id.

Другой проблемой с объектами или коллекциями является то, что ngModel не обнаружит, если свойство объекта или элемент коллекции изменится. По этой причине ngOptions дополнительно отслеживает модель, используя $watchCollection, когда выражение содержит track by фрагмент или select имеет атрибут multiple. Это позволяет ngOptions инициировать повторную отрисовку опций, даже если фактический объект/коллекция не изменила свою идентичность, но изменилось только свойство объекта или элемент коллекции.

Обратите внимание, что $watchCollection выполняет поверхностное сравнение свойств объекта (или элементов коллекции, если модель является массивом). Это означает, что изменение свойства глубже первого уровня внутри объекта/коллекции не вызовет повторной отрисовки.

select as

Использование select as свяжет результат выражения select с моделью, но значение элементов <select> и <option> html будет либо индексом (для массивов данных) или именем свойства (для объектных источников данных) значения внутри коллекции. Если используется выражение track by, результат этого выражения будет установлен в качестве значения элементов option и select.

select as и track by

Будьте осторожны при использовании select as и track by в одном выражении.

Учитывая этот массив элементов на $scope:

$scope.items = [{
  id: 1,
  label: 'aLabel',
  subItem: { name: 'aSubItem' }
}, {
  id: 2,
  label: 'bLabel',
  subItem: { name: 'bSubItem' }
}];

Это будет работать:

<select ng-options="item as item.label for item in items track by item.id" ng-model="selected"></select>
$scope.selected = $scope.items[0];

но это не сработает:

<select ng-options="item.subItem as item.label for item in items track by item.id" ng-model="selected"></select>
$scope.selected = $scope.items[0].subItem;

В обоих примерах выражение track by успешно применяется к каждому item в массиве items. Поскольку выбранный option был задан программно в контроллере, выражение track by также применяется к значению ngModel. В первом примере значение ngModel равно items[0], а выражение track by вычисляется в items[0].id без проблем. Во втором примере значение ngModel равно items[0].subItem, а выражение track by вычисляется в items[0].subItem.id (которое является неопределённым). В результате значение модели не совпадает ни с одним <option>, и <select> отображается как не имеющее выбранного значения.

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

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

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

  • в качестве атрибута:
    <ANY
      ng-model="string"
      [name="string"]
      [required="string"]
      [ng-required="string"]
      [ng-options="comprehension_expression"]>
    ...
    </ANY>

Аргументы

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

Присваиваемое выражение Angular для привязки к данным.

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

Имя свойства формы, в котором публикуется элемент управления.

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

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

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

Добавляет атрибут required и ограничение валидации required к элементу, когда выражение ngRequired истинно. Используйте ngRequired вместо required, если вы хотите привязать данные к атрибуту required.

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

в одном из следующих форматов:

  • для источников данных в виде массива:
    • label for value in array
    • select as label for value in array
    • label group by group for value in array
    • label disable when disable for value in array
    • label group by group for value in array track by trackexpr
    • label disable when disable for value in array track by trackexpr
    • label for value in array | orderBy:orderexpr track by trackexpr (для включения фильтра с track by)
  • для источников данных в виде объектов:
    • label for (key , value) in object
    • select as label for (key , value) in object
    • label group by group for (key, value) in object
    • label disable when disable for (key, value) in object
    • select as label group by group for (key, value) in object
    • select as label disable when disable for (key, value) in object

Где:

  • array / object: выражение, результатом которого является массив / объект для итерации.
  • value: локальная переменная, которая будет ссылаться на каждый элемент в массиве / значение каждого свойства объекта во время итерации.
  • key: локальная переменная, которая будет ссылаться на имя свойства в объекте во время итерации.
  • label: результат этого выражения будет меткой для элемента <option>. Скорее всего, expression будет ссылаться на переменную value (например, value.propertyName).
  • select: результат этого выражения будет привязан к модели родительского элемента <select>. Если не указано иное, выражение select будет по умолчанию value.
  • group: результат этого выражения будет использован для группировки опций с помощью элемента DOM <optgroup>.
  • disable: результат этого выражения будет использован для отключения отображаемого элемента <option>. Возвратите true, чтобы отключить.
  • trackexpr: используется при работе с массивом объектов. Результат этого выражения будет использован для идентификации объектов в массиве. Скорее всего, trackexpr будет ссылаться на переменную value (например, value.propertyName). Это позволяет сохранить выбор даже при пересоздании опций (например, при перегрузке с сервера).

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

Spec-Zone.ru

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