Имя окна или фрейма, где должен отображаться документ, возвращаемый в ответ на выполнение операции отправки формы.
Методы
boolean checkValidity
В броузерах, поддерживающих возможность проверки форм, этот метод проверяет корректность введенных данных в каждом элементе формы. Он возвращает true, если все данные корректны. Если какой-либо элемент управления содержит недопустимые данные, он возбуждает событие «invalid» в этом элементе формы и возвращает false.
void dispatchFormChange
Возбуждает
событие «formchange» в каждом элементе данной формы. Обычно это делается автоматически, когда действия пользователя приводят к возбуждению события «change», поэтому вызывать этот метод обычно не требуется.
void dispatchFormlnput
Возбуждает событие «forminput» в каждом элементе данной формы. Обычно это делается автоматически, когда действия пользователя приводят к возбуждению события «input», поэтому вызывать этот метод обычно не требуется.
void reset
Сбрасывает все элементы ввода формы к их значениям по умолчанию.
void submit
Выполняет отправку формы вручную, не возбуждая событие «submit».
Обработчики событий
Следующие обработчики событий, связанные с формами, определены в объекте
Element
, но описываются здесь, потому что возбуждаются в элементах
Form.
onreset
Вызывается непосредственно перед тем, как форма будет сброшена в исходное состояние. Чтобы предотвратить сброс, обработчик может вернуть false или отменить событие.
onsubmit
Вызывается непосредственно перед отправкой формы. Чтобы предотвратить отправку, обработчик может вернуть false или отменить событие.
FormControl
общие особенности всех элементов форм
Большинство элементов HTML-форм являются элементами
<input>,
но формы могут также содержать элементы
<button>, <select>
и
<textarea>.
Данная справочная статья описывает общие особенности всех этих элементов. Введение в HTML-формы приводится в разделе 15.9, а дополнительную информацию о формах и об элементах форм можно найти в справочных статьях
Form, Input, Select
и
TextArea
.
Элементы
<fieldset>
и
<output>
реализуют большинство, но не все, свойства, описываемые здесь. Данный справочник классифицирует объекты
FieldSet
и
Output
как подтипы объекта
FormControl
, хотя они реализуют не все свойства.
Данная справочная статья описывает некоторые особенности форм (такие
как проверка данных формы), введенные спецификацией HTML5, которые на момент написания этих строк были реализованы не во всех броузерах.
Свойства
boolean autofocus
Значение true, если элемент должен автоматически получать фокус ввода сразу после загрузки документа. (Элементы
FieldSet
и
Output
не реализуют это свойство.)
boolean disabled
Значение true, если элемент формы находится в неактивном состоянии. Неактивные элементы не откликаются на ввод пользователя и не подвергаются проверке. (Элементы
Output
не реализуют это свойство; элементы
FieldSet
используют его для управления активностью всех элементов, содержащихся в них.)
readonly Form form
Ссылка на элемент
Form
, который является владельцем данного элемента, или null, если таковой отсутствует. Если элемент формы находится внутри элемента
<form>,
эта форма является его владельцем. В противном случае, если элемент формы имеет HTML-атрибут
form
, определяющий значение атрибута
id
элемента
<form>,
владельцем элемента будет указанная форма.
readonly NodeList labels
Объект, подобный массиву, содержащий элементы
Label
, связанные с элементами этой формы. (Объекты
FieldSet
не реализуют это свойство.)
string name
Значение HTML-атрибута name для данного элемента формы. Имена элементов форм можно использовать в качестве имен свойств элемента
Form
: значениями таких свойств являются элементы форм. Имена элементов форм также можно использовать для идентификации данных при отправке формы.
string type
Для элементов
<input>
свойство type имеет значение атрибута type или значение «text», если атрибут type не указан в теге
<input>.
Для элементов
<button>, <select>
и
<textarea>
свойство
type
имеет значение «button», «select-one» (или «select-multiple», если установлен атрибут
multiple
) и «textarea», соответственно. Для элементов
<fieldset>
свойство
type
имеет значение «fieldset», а для элементов <output> - значение «output».