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

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

HTML SELECT элемент с привязкой данных Angular.

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

Когда в <select> меню выбирается элемент, значение выбранного параметра будет привязано к модели, определенной директивой ngModel. При статических или повторяющихся параметрах это содержимое атрибута value или значение textContent <option>, если атрибут value отсутствует. Если вам нужны динамические атрибуты value, вы можете использовать интерполяцию внутри атрибута value.

Обратите внимание, что значение директивы select без ngOptions всегда является строкой. Когда модель нужно привязать к значению, отличном от строки, необходимо либо явно преобразовать ее с помощью директивы (см. пример ниже), либо использовать ngOptions для указания набора параметров. Это связано с тем, что в настоящее время элемент option может быть привязан только к строковым значениям.

Если viewValue ngModel не совпадает ни с одним из параметров, элемент управления автоматически добавляет параметр «неизвестный», который удаляет при устранении несоответствия.

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

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

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

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

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

как элемент:

<select
  ng-model="string"
  [name="string"]
  [multiple="string"]
  [required="string"]
  [ng-required="string"]
  [ng-change="string"]
  [ng-options="string"]>
...
</select>

Аргументы

Параметр	Тип	Подробности
ngModel	`string`	Присваиваемое выражение Angular для привязки данных.
name (необязательно)	`string`	Имя свойства формы, в рамках которого публикуется элемент управления.
multiple (необязательно)	`string`	Разрешает выбор нескольких параметров. Выбранные значения будут привязаны к модели в виде массива.
required (необязательно)	`string`	Устанавливает `required` ключ ошибки валидации, если значение не введено.
ngRequired (необязательно)	`string`	Добавляет атрибут required и ограничение валидации required к элементу, когда выражение ngRequired принимает значение true. Используйте ngRequired вместо required, если вы хотите привязать данные к атрибуту required.
ngChange (необязательно)	`string`	Выражение Angular, которое должно быть выполнено, когда выбранный(ые) параметр(ы) изменяется из-за взаимодействия пользователя с элементом select.
ngOptions (необязательно)	`string`	устанавливает параметры, с которыми заполняется select, и определяет, что устанавливается в модели при выборе. См. `ngOptions`.

Простые элементы select со статическими параметрами

Использование ngRepeat для генерации параметров select

Использование select с ngOptions и установка значения по умолчанию

См. документацию ngOptions для получения дополнительных ngOptions примеров использования.

Связывание select со значением, отличным от строки, через ngModel (парсинг/форматирование)

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