checkbox NN 2   IE 3   DOM 1

Объект checkbox - элемент формы, сгенерированный с помощью атрибута TYPE="checkbox" элемента INPUT.

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

 
Эквивалент HTML

<INPUT TYPE="checkbox">

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

Свойства:


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

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

 
Пример:

document.entryForm.myCheckbox.accessKey = "n"

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

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

Установлена ли галочка на переключатель. Переключатели работают независимо от друг друга (можно установить сколь угодно галочек в пределах 1 группы). Только объекты checkbox со свойством checked = true отправляются на сервер вместе с формой..

 
Пример:

if (document.choiceForm.monitors.checked) { process for the "monitors" checkbox being checked }

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

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

Используется с IE 4 для закрепления данных, чтобы привязать имя отдаленного столбца источника данных к собственному значению объекта "checkbox". Атрибут dataSrc уже должен быть установлен для элемента. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом.

 
Пример:

document.myForm.myCheckbox.dataFld = "linkURL"

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

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

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

 
Пример:

document.myForm.myCheckbox.dataSrc = "#DBSRC3"

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

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

Отмечен ли объект галочкой по умолчанию. Вы можете сравнивать текущее состояние свойства checked с defaultChecked, чтобы установить, изменилось ли состояние элемента после загрузки документа. Изменение этого свойства не затрагивает текущее состояние checked .

 

Пример:

var cBox = document.forms[0].checkbox1 if (cBox.checked != cBox.defaultChecked) { process for changed state }

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: Устанавливается атрибутом тэга.

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

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

 
Пример:

document.forms[0].myCheckbox.disabled = true

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

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

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

 
Пример:

<INPUT TYPE="button" VALUE="Validate Form" onClick="doValidate(this.form)">

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

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

Является ли переключатель типом "ни checked, ни unchecked, но всё же активен". Этот "средний" тип по разному реализован в различных операционных системах. В Windows переключатель недоступен (с пометкой "все еще видимый", если она была там первоначально) но все же активен (серого цвета). На Macintosh переключатель отображает дефис внутри поля. Состояние indeterminate обычно предполагает, что изменение чего-либо в другом месте, вероятно, воздействует на этот переключатель и выводит его из этого состояния.

 
Пример:

document.orderForm.2DayAir.indeterminate = true

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

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

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

 
Пример:

document.orderForm.myCheckbox.name = "Win32"

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

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>

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

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

Это свойство идентично свойству value.

 
Пример:

if (document.forms[0].56KbpsBox.status) { ... }

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

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

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

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

 
Пример:

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

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

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

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

 
Пример:

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

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

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

Текущее значение, связанное с элементом формы, который представлен парой "имя/значение" для элемента (отмечен ли галочкой). Все значения - строки, но они могут представлять другие типы данных, включая Булевы и числовые значения.

 
Пример:

document.forms[0].myBox.value = "*"

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

Методы:


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

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

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

click( ) NN 4  IE 4  DOM 1

Имитирует нажатие пользователя на флажке.

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

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

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

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

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

handleEvent(event)

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

 
Возвращаемое значение
None.
 
Параметры
event Объекты событий Navigator 4

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




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