JavaScript. Подробное руководство, 6-е издание

Подробнее об HTML-формах рассказывается в разделе 15.9. Кроме того, дополнительную информацию об элементах форм можно найти в справочных статьях FormControl, FieldSet, Input, Label, Select и TextArea.

Данная справочная статья описывает некоторые особенности форм, определяемые спецификацией HTML5, которые на момент написания этих строк были реализованы не во всех броузерах.

Свойства

Большинство свойств, перечисленных ниже, просто соответствуют HTML-атрибутам с теми же именами,

  string acceptCharset

Список из одного или более допустимых кодировок символов, которые могут использоваться для кодирования данных формы при отправке.

  string action

URL-адрес, по которому должна быть отправлена форма.

  string autocomplete

Строка «оn» или «off». Если содержит строку «оn», броузер будет предварительно заполнять элементы формы значениями, сохраненными при предыдущем посещении страницы.

  readonly HTMLFormControlsCollection elements

Объект, подобный массиву, содержащий элементы формы.

  string enctype

Определяет способ кодирования значений элементов формы при отправке. Допустимыми значениями являются:

• «application/x-www-form-urlencoded» (по умолчанию)

• «multipart/form-data»

• «text/plain»

  readonly long length

Количество элементов формы, представляемых свойством elements. Формы действуют, как если бы они сами были объектами, подобными массивам, содержащими элементы форм, поэтому для формы f и целого числа n выражение f[n] будет эквивалентно выражению f.elements[n].

  string method

HTTP-метод отправки формы по URL-адресу в свойстве action. Может иметь значение «get» или «post».

  string name

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

  boolean noValidate string target

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

Методы

  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 используют его для управления активностью всех элементов, содержащихся в них.)