Массив options - Справочник по JavaScript

options

NN 2 IE 3 DOM n/a

Массив элементов OPTION вложенных внутри объекта SELECT.

Объектно-ориентированная модель

NN	[window.]document.formName.selectName.options
IE	[window.]document.formName.selectName.options

Свойства:

length	NN 2 IE 3 DOM n/a

	Только чтение

Возвращает число элементов в коллекции.

Пример: var howMany = document.forms[0].mySelect.options.length

Возвращаемое значение: Целое число.

Методы:

Add()

NN n/a IE 4 DOM n/a

add(element, [index])

Добавляет уже созданный элемент (от метода createElement()) к текущей коллекции. Элемент должен иметь тип OPTION. По умолчанию, если Вы не определите индексное значение как второй параметр, новый элемент добавляется как последний элемент коллекции. Следующая последовательность добавляет в конец массива объекта SELECT новый элемент :

var newElem = document.createElement("OPTION") newElem.text = "Freddy" newElem.value = "Freddy Mercury" document.forms[1].rockers.options.add(newElem)

Обратите внимание, что сначала создаётся объект newElem. Затем его свойства наполняются значениями. Затем новый элемент физически добавляется к элементу SELECT.

В Navigator <= 4 процесс добавления элемента OPTION полностью отличен. Чтобы добавить в конец новый элемент, назначите его как результат конструктора Option( ) последнему индексу массива (соответствующему целому числу, возвращенному свойством length). Параметры для функции конструктора (по порядку):

Строка, соответствующая свойству text

Строка, соответствующая свойству value

Булева переменная, соответствующая свойству defaultSelected

Булева переменная, соответствующая свойству selected

Например, версия для Navigator предшествующего примера (для IE):

document.forms[1].rockers.options[length] = new Option("Freddy", "Freddy Mercury", false, false)

Вы можете вставлять новый элемент где-нибудь в другом месте в списке, определяя желательное индексное значение массива options.

Возвращаемое значение
None.

Параметры

element	Полностью сформированная ссылка на объект, обычно генерируемая методом createElement().
index	Дополнительное целое число, указывающее, куда новый элемент должен быть помещен в массиве.

item( )

NN n/a IE 4 DOM n/a

item(index[, subindex])

Возвращает отдельный объект или коллекцию объектов, соответствующих элементу, соответствующему индексному значению (или, если точно, произвольному индексу и субиндексу).

Возвращаемое значение
Один объект или коллекция (массив) объектов. Если нет никаких пар к параметрам, возвращенное значение будет 0.

Параметры

index

Когда параметр - отсчитываемое от нуля целое число, возвращенное значение - отдельный элемент, соответствующий упомянутому номеру в порядке исходного кода; когда параметр - строка, возвращенное значение - коллекция элементов чьи свойства id или name соответствуют этой строке

subindex

Если Вы определяете строковое значение для первого параметра, Вы можете использовать второй параметр, чтобы определить отсчитываемое от нуля целое число, представляющее индекс элемента, определённого в первом параметре

Remove()

NN n/a IE 4 DOM n/a

remove(index)

Удаляет элемент из текущей коллекции. Просто определите отсчитываемое от нуля индексное значение элемента OPTION, который Вы желаете удалить из коллекции, принадлежащей элементу SELECT. Следующий пример удаляет первый элемент из объекта SELECT:

document.forms[1].rockers.options.remove(0)

В Navigator процесс удаления элемента OPTION абсолютно различен . Чтобы удалить элемент, назначите нуль на его индекс в коллекции. Например, Navigator-версия предшествующего примера IE:

document.forms[1].rockers.options[0] = null

Независимо от браузера, длина массива options не заполняет пустое пространство.

Возвращаемое значение
None.

Параметры

index

Отсчитываемое от нуля целое число, указывающее, какой элемент в коллекции должен быть удален.

HIVE: All information for read only. Please respect copyright!