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

Читает байты из объекта

<b>blob</b>
, преобразует их в двоичную строку (
<b>String.fromChar-Code()</b>
) и возвращает ее.

<b>string readAsDataURL(Blob blob)</b>

Читает байты из объекта

<b>blob</b>
, преобразует их с учетом свойства
<b>type</b>
объекта
<b>blob</b>
в URL-адрес data:// и возвращает его.

<b>string readAsText(Blob blob, [string encoding])</b>

Читает байты данных из объекта

<b>blob</b>
, декодирует их с использованием кодировки
<b>encoding</b>
(или с использованием кодировки UTF-8 или UTF-16, если аргумент
<b>encoding</b>
не указан) и возвращает полученную строку.

Form

тег <form> в HTML-документе (Node, Element)

Объект

<b>Form</b>
представляет элемент
<b>&lt;form&gt;</b>
в HTML-документе. Свойство
<b>elements</b>
- это объект
<b>HTMLCollection</b>
, который дает удобный доступ ко всем элементам в форме. Методы
<b>submit()</b>
и
<b>reset()</b>
позволяют программным способом отправлять данные формы или сбрасывать все элементы формы в значения, предлагаемые по умолчанию. Каждая форма в документе представлена элементом массива
<b>document.forms[].</b>
Элементы формы (кнопки, поля ввода, переключатели и т. д.) собраны в объекте
<b>Form.elements</b>
, подобном массиву. К именованным элементам форм можно обращаться непосредственно по имени - имя элемента выступает в качестве имени свойства объекта
<b>Form</b>
. Другими словами, обратиться к элементу
<b>Input</b>
со значением «phone» в свойстве
<b>name</b>
в форме f можно посредством JavaScript-выражения
<b>f.phone</b>
.

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

<b>FormControl, FieldSet, Input, Label, Select</b>
 и
<b>TextArea</b>
.

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

Свойства

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

<b>string acceptCharset</b>

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

<b>string action</b>

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

<b>string autocomplete</b>

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

<b>readonly HTMLFormControlsCollection elements</b>

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

<b>string enctype</b>

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

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

• «multipart/form-data»

• «text/plain»

<b>readonly long length</b>

Количество элементов формы, представляемых свойством

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

<b>string method</b>

HTTP-метод отправки формы по URL-адресу в свойстве

<b>action</b>
. Может иметь значение «get» или «post».

<b>string name</b>

Имя формы, определяемое HTML-атрибутом

<b>name</b>
. Значение этого свойства можно использовать в качестве имени свойства объекта документа, значением которого будет данный объект
<b>Form</b>
,

<b>boolean noValidate string target</b>

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

Методы

<b>boolean checkValidity()</b>

В броузерах, поддерживающих возможность проверки форм, этот метод проверяет корректность введенных данных в каждом элементе формы. Он возвращает true, если все данные корректны. Если какой-либо элемент управления содержит недопустимые данные, он возбуждает событие «invalid» в этом элементе формы и возвращает false.

<b>void dispatchFormChange()</b>

Возбуждает событие «formchange» в каждом элементе данной формы. Обычно это делается автоматически, когда действия пользователя приводят к возбуждению события «change», поэтому вызывать этот метод обычно не требуется.

<b>void dispatchFormlnput()</b>

Возбуждает событие «forminput» в каждом элементе данной формы. Обычно это делается автоматически, когда действия пользователя приводят к возбуждению события «input», поэтому вызывать этот метод обычно не требуется.

<b>void reset()</b>

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

<b>void submit()</b>

Выполняет отправку формы вручную, не возбуждая событие «submit».

Обработчики событий

Следующие обработчики событий, связанные с формами, определены в объекте

<b>Element</b>
, но описываются здесь, потому что возбуждаются в элементах
<b>Form.</b>

<b>onreset</b>

Вызывается непосредственно перед тем, как форма будет сброшена в исходное состояние. Чтобы предотвратить сброс, обработчик может вернуть false или отменить событие.

<b>onsubmit</b>

Вызывается непосредственно перед отправкой формы. Чтобы предотвратить отправку, обработчик может вернуть false или отменить событие.