Option

элемент <option> в элементе Select (Node, Element)

Объект Option описывает вариант выбора внутри объекта Select. Свойства этого объекта определяют, выбран ли вариант по умолчанию или вариант, который выбран в данный момент, а также задают позицию, которую он занимает в массиве options[] содержащего его объекта Select, отображаемый им текст и значение, которое он передает на сервер при передаче данных родительской формы.

По историческим причинам элемент Option определяет конструктор, который можно использовать для создания и инициализации новых элементов Option. (Разумеется, можно также использовать обычный метод Document.createElement().) После создания нового объекта Option его можно добавить в коллекцию options в объект Select. Дополнительные сведения приводятся в справочной статье HTMLOptionsCollection.

Конструктор

new Option([string text, string value, boolean defaultSelected, boolean selected])

Конструктор Option() создает новый элемент <option>. Четыре необязательных аргумента определяют значение свойства textContent (см. Node) элемента и начальные значения свойств value, defaultSelected и selected.

Свойства

boolean defaultSelected

Соответствует HTML-атрибуту selected. Определяет начальное значение состояния выбора данного варианта, а также значение, которое будет использоваться при сбросе формы в исходное состояние.

boolean disabled

Значение true означает, что данный элемент <option> недоступен. Варианты выбора становятся недоступными, если они или вмещающие их элементы <optgroup> имеют HTML-атрибут disabled.

readonly Form form

Элемент <form>, если имеется, содержащий данный элемент Option.

readonly long index

Индекс данного элемента Option в содержащем его элементе Select. (См. также

HTMLOptionsCollection.) string label

Значение HTML-атрибута label, если определен, иначе - значение свойства textContent (см. Node) данного элемента Option.

boolean selected

Имеет значение true, если данный вариант выбора выбран в настоящее время, или false - в противном случае.

string text

Значение свойства textContent (cm. Node) данного элемента Option, из которого удалены начальные и завершающие пробельные символы, а каждые два или более смежных пробелов заменены одним символом пробела.

string value

Значение HTML-атрибута value, если определен, иначе - значение свойства textContent.