Читает байты из объекта
<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><form></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 или отменить событие.
