SELECT NN 2   IE 3   DOM 1

SELECT отражает элемент HTML SELECT.Этот элемент - элемент формы, который содержит элементы OPTION. Обратите внимание, что свойства innerHTML и innerText не доступны в версии Macintosh Internet Explorer 4. По-умолчанию элемент Select отображается как всплывающий список. Чтобы он отображался как прокручивающийся список, необходимо установить атрибут size в значение > 1. Для предоставления возможности выбора нескольких элементов необходимо установить атрибут multiple.

Общие свойства, методы и обработчики событий перечислены в разделе "Все злементы HTML"

 
Эквивалент HTML

<SELECT>

 
Объектно-ориентированная модель
NN [window.]document.formName.selectName
[window.]document.forms[i].elements[i]
IE [window.]document.formName.selectName
[window.]document.forms[i].elements[i]
[window.]document.all.elementID
NN 6/IE5+ [window.]document.getElementById("elementID")

Свойства:


accessKey NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Отдельная клавиша клавиатуры, которая передаёт фокус элементу. Браузер и операционная система определяют, должен ли пользователь нажать клавишу-модификатор (например, Ctrl, Alt, или Команду) вместе с клавишей доступа, чтобы передать фокус элементу. В IE 4/Windows требуется клавиша Alt , и она не чувствительна к регистру. Не работает в IE 4/Mac.

 
Пример:

document.entryForm.mySelect.accessKey = "n"

 
Возвращаемое значение:
Отдельный алфавитно-цифровой или пунктуационный символ клавиатуры.
 
Значение по умолчанию: Ничего.

dataFld NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Используется с IE 4 для закрепления данных to associate a remote data source column name with the selectedIndex property of the SELECT object. Атрибут dataSrc уже должен быть установлен для элемента. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом

 
Пример:

document.forms[0].mySelect.dataFld = "choice"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор столбца источника данных
 
Значение по умолчанию: Ничего.

dataSrc NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Используется с IE 4 для закрепления данных, чтобы связать имя удаленного источника данных ODBC (типа Oracle или SQL Server database) с элементом. Содержание из источника данных определено через атрибут dataFld. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом.

 
Пример:

document.forms[0].mySelect.dataSrc = "#DBSRC3"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор источника данных.
 
Значение по умолчанию: Ничего.

disabled NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Является ли элемент доступным для взаимодействия с пользователем. Когда установлено true, элемент не может получать фокус или изменяться пользователем. Это никак не связано с формой.

 
Пример:

document.forms[0].elements[3].disabled = true

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

form NN 2   IE 3   DOM n/a
 Только чтение
 

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

 
Пример:

<SELECT NAME="units" onChange="recalc(this.form)">

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

length NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Число объектов OPTION, вложенных внутрь объекта SELECT. Вы можете корректировать это значение вверх или вниз, но есть некоторое определенное браузером поведение. Чтобы добавлять опции объекту SELECT, Вы должны следовать определенному браузером правилу создания новых объектов OPTION (см. объект options для подробностей). Если Вы устанавливаете это свойство на число, меньшее, чем его первоначальное значение, объекты OPTION будут удалены из нижней части списка. Значение 0 не заставляет элементы исчезать, но в элементе нет никаких выбираемых опций.

 
Пример:

document.forms[0].mySelect.length = 3

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

multiple NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Должен ли браузер выполнить элемент SELECT как список и позволить пользователям делать множественные выборы из списка опций. По умолчанию свойство size установлено в соответствии с числом вложенных элементов OPTION, но это значение может отмениться с его установкой. Свойство multiple не имеет никакого эффекта, когда размер установлен на 1.

 
Пример:

if (document.entryForm.list3.multiple) { ... }

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

name NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Идентификатор, связанный с элементом формы. Значение этого свойства представляется как половина пары "имя/значение", когда форма отправляется на сервер. Имена скрыты от пользователя, так как метки элемента назначены через другие средства в зависимости от типа элемента. Имена элементов формы могут также использоваться ссылками сценария на эти объекты.

 
Пример:

document.orderForm.payment.name = "credcard"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор, который подчиняется правилам именования: не может содержать никаких пробелов, не может начинаться с цифры и не должен содержать пунктуационных символов кроме символа подчеркивания.
 
Значение по умолчанию: Ничего.

recordNumber NN n/a  IE 4   DOM n/a
 Только чтение
 

Используется для связи с источником данных, возвращает целое число, представляющее запись в пределах набора данных, который сгенерировал элемент (то есть, элемент, чьё содержание заполнено через связь с источником данных). Значения этого свойства могут использоваться, чтобы извлечь определенную запись из набора записей Active Data Objects (ADO) (см. свойство recordset ).

 
Пример:

<SCRIPT FOR="tableTemplate" EVENT="onclick"> myDataCollection.recordset.absoluteposition = this.recordNumber ... </SCRIPT>

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

selectedIndex NN 2   IE 3   DOM 1
  Чтение/Изменение
 

Отсчитываемое от нуля целое число опции, выбранной пользователем, соответствующее её индексу в массиве. Если элемент SELECT установлен так, чтобы позволить множественный выбор, свойство selectedIndex возвращает индекс первого выбранного пункта (см. свойство selected). Вы можете использовать это свойство, чтобы получить доступ к свойству value или text выбранного пункта, как показано в примере.

 
Пример:

var list = document.forms[0].selectList var listValue = list.options[list.selectedIndex].value

 
Возвращаемое значение:
Положительное целое число.
 
Значение по умолчанию: Ничего.

size NN 6  IE 4  DOM 1
  Чтение/Изменение
 

Свойство size соответствует атрибуту size элемента. Оно показывает, сколько элементов видимо на странице без прокрутки.

 
 
 
Возвращаемое значение:
Положительное целое число.
 
Значение по умолчанию: 1

tabIndex NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Номер, который указывает последовательность этого элемента в пределах порядка размещения всех форматируемых элементов в документе. Порядок форматирования строго подчиняется набору правил. Элементы, которые имеют отличные от нуля значения свойства tabIndex, находятся первые в строке, когда пользователь начинает форматирование страницы. Отсчёт начинается с элемента с самым низким значением tabIndex и заканчивается самым высоким значением, независимо от физического местоположения объекта на странице или в документе. Если два элемента имеют одни и те же значения tabIndex, элемент, который загружается в документ раньше , получает фокус первым. Затем идут все элементы что, или не поддерживающие свойство tabIndex , или имеющие нулевое значение. Эти элементы получают фокус в том порядке, в котором они загружаются в документ. Значение -1 ,в целом, удаляет элемент из порядка форматирования.

Обратите внимание, что интерфейс Macintosh не обеспечивает предоставление фокуса элементам, отличным от text и password поля INPUT.

 
Пример:

document.forms[0].choices.tabIndex = 6

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

type NN 3   IE 4   DOM 1
 Только чтение
 

Возвращает тип элемента формы. Объект SELECT имеет два возможных значения, в зависимости от того, является ли элемент способным на множественный выбор. Значение возвращается в символах нижнего регистра.Может быть использовано, если необходимо циклически пройти все элементы формы в поиске определенных типов, чтобы сделать некоторую корректировку (например, освободить все элементы формы типа "text" при оставлении других элементов нетронутыми).

 
Пример:

if (document.forms[0].elements[3].type == "select-multiple") { ... }

 
Возвращаемое значение:
Любая из следующих констант (как строка): button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.
 
Значение по умолчанию: Зависит от элемента.

value NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Текущее значение, связанное с элементом формы, который представлен парой "имя/значение" для элемента. Все значения - строки, но они могут представлять другие типы данных, включая Булевы и числовые значения. Internet Explorer автоматически изменяет свойство value выбранного объекта OPTION в соответствии со значенем value объекта SELECT.

 
Пример:

if (document.forms[0].medium.value == "CD-ROM") { ... }

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

Методы:


blur( ) NN n/a  IE 4   DOM n/a

Удаляет фокус из текущего элемента и обрабатывает событие onBlur (в IE). Никакой другой элемент в результате не получает фокус (обязательно).

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

focus( ) NN n/a  IE 4   DOM n/a

Дает фокус текущему элементу и обрабатывает событие onFocus (в IE). Если другой элемент имел фокус в то время, он получает событие onBlur.

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

item( ) NN 6

item(index)

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

 
Возвращаемое значение
объект OPTION
 
Параметры
index отсчитываемое от нуля целое число, соответствующее индексу в порядке исходного кода

NamedItem( ) NN n/a  IE 4   DOM n/a

item("elementID")

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

 
Возвращаемое значение
коллекция элементов чьи свойства id соответствуют этой строке
 
Параметры
elementID строка

Динамические коллекции:

options[ ] NN 2  IE 3   DOM 1

Массив всех объектов OPTION, содержащихся в текущем элементе. Элементы в этом массиве индексированы (начиная с нуля) в порядке исходного текста. Для подробностей относительно использования этой коллекции для добавления и удаления элементов OPTION из элемента SELECT в Internet Explorer, см. объект options.


tags[ ] NN n/a  IE 4   DOM n/a

Массив всех объектов, определенных HTML тэгами, содержащихся в текущем элементе.

 
Синтаксис

selectObject.tags("tagName")[i].objectPropertyOrMethod


Определённые обработчики событий:




HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека