form NN 2   IE 3   DOM 1

FORM отражает элемент HTML FORM.Объект FORM может быть вызван в ссылке значением, назначенным на его тэг атрибутом NAME или индексом массива forms, солержащимся в каждом документе. Чтобы обратиться через ссылку на элемент формы, объект FORM должен являться частью ссылки.

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

<FORM onSubmit="someFun(this)">

Это упрощает ссылку на элементы данной формы в функции.

Если вы, например, хотите, чтобы после отправки данных формы на сервер пользователю открывалась страничка с подтверждением отправки, то, вероятно, вы свяжете обработчик события onSubmit со следующей функцией:

function doSubmitt() {
    document.forms[0].submit();
    location.href = "thanks.html";
}

В результате выполнения данной функции никакие данные на сервер отправлены не будут, т.к если после метода submit() выполняются какие-то другие операторы, отправка данных отменяется. Можно это обойти с помощью setTimeout(), но кто его знает, какая у пользователя скорость соединения. Если данные не успеют быть отправлены, их отправка отменится. Универсального способа решения данной проблемы пока не придумали.

Хочется сказать по поводу элементов форм: если вы одинаково называете несколько элементов внутри одной формы (с помощью name, а не id), они автоматически становятся массивами объектов.

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

 
Эквивалент HTML

<FORM>

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

Свойства:


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) как строка. Для нескольких элементов необходим список с разделителями-запятыми в одну строку.
 
Значение по умолчанию: application/x-www-form-urlencoded

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.
 
Значение по умолчанию: get

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 создает новое окно заданного по умолчанию размера.
 
Значение по умолчанию: None

Методы:


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

handleEvent(event)

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

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

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!
Hosted by hive КГБ: Киевская городская библиотека