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

Флэнаган Дэвид

readonly string validationMessage

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

readonly FormValidity validity

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

string value

Каждый

элемент формы имеет строковое свойство

value

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

value

. Для элементов

Output

это свойство подобно свойству

textContent

, унаследованному от объекта

Node

. Элементы

FieldSet

не реализуют это свойство.

readonly boolean willValidate

Это свойство имеет значение true, если элемент формы подвергается проверке, и false - в противном случае.

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

Элементы форм определяют следующие свойства обработчиков событий. Обработчики можно также регистрировать с помощью методов интерфейса

EventTarget

, который реализуют все элементы:

Обработчик событий - Когда вызывается

onformchange

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

onforminput

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

oninvalid - Если в ходе проверки выяснится, что элемент формы содержит некорректные данные, в нем будет возбуждено событие «invalid». Это событие не всплывает, но если его отменить, броузер не выведет сообщение об ошибке для этого элемента.

Методы

boolean checkValidity

Возвращает true, если элемент формы содержит корректные данные (или если этот элемент не подвергается проверке). Иначе возбуждает событие «invalid» в данном элементе и возвращает false.

void setCustomValidity(string error)

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

Form Data

тело HTTP-запроса multipart/form-data

Тип

FormData

является частью спецификации «XMLHttpRequest Level 2» (XHR2), которая упрощает отправку данных в формате «multipart/form-data» в виде НТТР-за-просов PUT с помощью объекта

XMLHttpRequest

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

File

. Создайте объект

FormData

с помощью конструктора и затем добавьте в него пары имя/значение с помощью метода

append.

После того как будут добавлены все части, составляющие тело запроса, объект

FormData

можно передать методу

send

объекта

XMLHttpRequest

.

Конструктор

new FormData

Этот конструктор, не имеющий аргументов, возвращает пустой объект FormData.

Методы

void append(string name, any value)

Добавляет в объект

FormData

новую часть с именем

name

и значением

value

. Аргумент

value

может быть строкой или объектом

Blob

(напомню, что

тип

File является подтипом

Blob

).

FormValidity

реализует проверку элемента формы

Свойство

validity

объекта

FormControl

ссылается на объект

FormValidity

, который является представлением признака корректности данных в этом элементе формы. Если свойство

valid

имеет значение false, элемент формы содержит недопустимые данные и по крайней мере одно из других свойств, определяющих природу ошибки (или ошибок), будет иметь значение true.

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

Свойства

readonly boolean customError

Сценарий вызвал метод

FormControl.setCustomValidity

данного элемента.

readonly boolean patternMismatch

Введенные данные не соответствуют регулярному выражению.