JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

NodeList

доступный только для чтения объект, подобный массиву, содержащий узлы

NodeList

– это доступный только для чтения объект, подобный массиву, содержащий объекты

Node

(обычно элементы). Свойство

length

указывает, сколько узлов находится в списке; эти узлы можно извлекать, используя индексы от 0 до

length

– 1. Вместо непосредственного индексирования объекта

NodeList

можно также

использовать метод

item.

Элементы

NodeList

всегда являются корректными объектами

Node

: объект

NodeList

никогда не содержит пустых (null) элементов.

Объектами

NodeList

, например, являются свойство

childNodes

и возвращаемые значения методов

Document.getElementsByTagName, Element.getElementsByTagName

и

HTMLDocu-ment.getElementsByName.

Поскольку объект

NodeList

является объектом, подобным массиву, в книге эти значения часто неформально называются массивами, например «массив childNodes».

Обратите внимание: объекты

NodeList

обычно являются «живыми»: они динамически отражают изменения в дереве документа. Например, если

NodeList

представляет дочерние узлы для указанного узла и вы удалите один из этих дочерних узлов, он будет удален и из вашего объекта

NodeList

. Будьте аккуратны при выполнении цикла по элементам

NodeList

, если тело цикла вносит изменения в дерево документа (например, удаляет узлы), которые могут влиять на содержимое

NodeList

!

Свойства

readonly unsigned long length

Количество узлов в объекте

Node

List.

Методы

Node item(unsigned long index)

Возвращает узел в позиции index или null, если индекс index выходит за границы.

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

.

Output

элемент <output> HTML-форм (Node, Element, FormControl)

Объект

Output

представляет элемент

<output>

HTML-форм. В броузерах, поддерживающих их, объекты

Output

реализуют большинство свойств интерфейса

FormControl

.