form | NN 2 IE 3 DOM 1 | ||||||
FORM отражает элемент HTML FORM.Объект FORM может быть вызван в ссылке значением, назначенным на его тэг атрибутом NAME или индексом массива forms, солержащимся в каждом документе. Чтобы обратиться через ссылку на элемент формы, объект FORM должен являться частью ссылки. Когда форма содержит обработчик события, вызывающий функцию, в эту функцию можно передать данную форму в качестве параметра. <FORM onSubmit="someFun(this)"> Это упрощает ссылку на элементы данной формы в функции. Если вы, например, хотите, чтобы после отправки данных формы на сервер пользователю открывалась страничка с подтверждением отправки, то, вероятно, вы свяжете обработчик события onSubmit со следующей функцией: function doSubmitt() { В результате выполнения данной функции никакие данные на сервер отправлены не будут, т.к если после метода submit() выполняются какие-то другие операторы, отправка данных отменяется. Можно это обойти с помощью setTimeout(), но кто его знает, какая у пользователя скорость соединения. Если данные не успеют быть отправлены, их отправка отменится. Универсального способа решения данной проблемы пока не придумали. Хочется сказать по поводу элементов форм: если вы одинаково называете несколько элементов внутри одной формы (с помощью name, а не id), они автоматически становятся массивами объектов. Общие свойства, методы и обработчики событий перечислены в разделе "Все злементы HTML" |
|||||||
Эквивалент HTML
<FORM> |
|||||||
Объектно-ориентированная модель
|
Свойства:
acceptCharset | NN 6 | ||
Чтение/Изменение | |||
Свойство acceptCharset представляет собой атрибут acceptCharset элемента form в HTML 4.0. Его значение - список одного или более набора символов, которые сервер, принимающий форму, должен поддерживать. |
|||
Возвращаемое значение: Строковое значение. Для просмотра допустимых значений см. ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets |
|||
|
action | NN 2 IE 3 DOM 1 | ||
Чтение/Изменение | |||
URL файла, в который отправляется форма. Назначение сценарием этого свойства позволяет одной форме быть отправленной различным файлам сервера,на основании взаимодействия с пользователем. Это свойство имеет атрибут "только для чтения" в IE 3. |
|||
Пример:
document.entryForm.action = "http://www.megacorp.com/cgi-bin/altEntry" |
|||
Возвращаемое значение: Полный или относительный URL. |
|||
|
autocomplete | NN n/a IE 5 (кроме IE5/Mac) | ||
Чтение/Изменение | |||
Microsoft добавила в формы, отображаемые в IE5, свойство, которое позволяет броузеру снабжать пользователя подсказками для облегчения заполнения элементов управления формы, если их названия представляют собой набор однострочных текстовых полей, определённых с помощью дополнительных атрибутов, задаваемых vCard XML структурой. Подробно о поддержке этого свойства вы можете смотреть http://msdn.microsoft.com/workshop/autor/forms/autocomplete_ovr.asp . |
|||
Возвращаемое значение: Одна из 2 строк: on или off. |
|||
|
encoding, enctype | NN 2 IE 3 DOM n/a | ||
Чтение/Изменение | |||
Тип MIME данных, отправляемый на сервер формой. Соответствует атрибуту ENCTYPE. Для типовых отправок формы (где установлен атрибут METHOD=post), content-type соответствует значение по умолчанию. Но если Вы изменяете свойство action с помощью сценария, рассмотрите, требуется ли Вы специфическое кодирование для данных. В NN6 свойство encoding называется enctype. Обратите внимание, что свойство encoding не поддаётся изменению в Internet Explorer 3. | |||
Пример:
document.orderForm.encoding = "text/plain" | |||
Возвращаемое значение: Тип MIME Без учета регистра (content-type) как строка. Для нескольких элементов необходим список с разделителями-запятыми в одну строку. |
|||
|
length | NN 2 IE 3 DOM n/a | ||
Только чтение | |||
Число элементов в форме. | |||
Пример:
for (var i = 0; i < document.forms[0].length; i++) ... } | |||
Возвращаемое значение: Целое число. | |||
|
method | NN 2 IE 3 DOM 1 | ||
Чтение/Изменение | |||
Формы могут быть отправлены двумя методами HTTP: get и post. Эти методы определяют, посылаются ли данные формы при помощи добавления в конец строки URL (get) или как сообщение (post). Когда атрибуты ACTION и METHOD не определены в элементе FORM, форма восстанавливает элементы к их значениям по умолчанию. Обратите внимание, что в Internet Explorer 3 свойство METHOD только для чтения. Чтобы отправить форму с помощью протокола mailto:, свойство (или атрибут) method должен быть равен POST. | |||
Пример:
document.entryForm.method = "post" | |||
Возвращаемое значение: Любое из следующих постоянных значений как строка: get | post. |
|||
|
name | NN 2 IE 3 DOM 1 | ||
Чтение/Изменение | |||
Имя формы. Эта информация не отправляется на сервер с формой, но имя формы используется в сценариях | |||
Пример:
var firstFormName = document.forms[0].name | |||
Возвращаемое значение: Чувствительный к регистру идентификатор, который подчиняется правилам именования: не может содержать никаких пробелов, не может начинаться с цифры и не должен содержать пунктуационных символов кроме символа подчеркивания. | |||
|
target | NN 2 IE 3 DOM 1 | ||
Чтение/Изменение | |||
Имя окна или фрейма, который должен получить содержание, возвращенное сервером после отправления формы . Такие имена назначены на фреймы через атрибут NAME элемента FRAME ; для окон имя назначено через второй параметр метода window.open() . | |||
Пример:
document.myForm.target = "_top" | |||
Возвращаемое значение: Строковое значение имени окна или фрейма, или 1 из следующих констант (как строка): _parent | _self | _top | _blank. _parent - frameset, которому текущий документ принадлежит; _self - текущее окно; _top - основное окно броузера, таким образом устраняя все фреймы; _blank создает новое окно заданного по умолчанию размера. |
|||
|
Методы:
handleEvent( ) | NN 4 IE n/a DOM n/a | ||
handleEvent(event) Инструктирует объект обрабатывать событие, чья спецификация представлена как параметр для метода. Объект должен иметь обработчик события для типа события, чтобы обработать его. | |||
Возвращаемое значение None. | |||
Параметры
|
reset( ) | NN 3 IE 4 DOM n/a |
Все элементы формы возвращаются к их значениям по умолчанию. | |
Возвращаемое значение None. | |
Параметры None. |
submit( ) | NN 2 IE 3 DOM n/a |
Отправка формы на сервер. Этот метод не обрабатывает событие onSubmit в Navigator. | |
Возвращаемое значение None. | |
Параметры None. |
Динамические коллекции:
elements[ ] | NN 2 IE 3 DOM n/a |
Возвращает массив всех объектов элементов , содержащихся в текущей форме. |
|
Синтаксис
document.forms[i].elements(index).objectPropertyOrMethod |
Определённые обработчики событий:
HIVE: All information for read only. Please respect copyright! |