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

Флэнаган Дэвид
Шрифт:

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

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

readonly boolean rangeOverflow

Объем введенных данных слишком велик.

readonly boolean rangeUnderflow

Объем введенных данных слишком мал.

readonly boolean stepMismatch

Введенные данные не соответствуют указанному шагу.

readonly boolean tooLong

Объем введенных данных слишком велик.

readonly boolean typeMismatch

Введенные данные имеют неверный тип.

readonly boolean valid

Если это свойство имеет значение true, элемент формы содержит корректные данные и все другие свойства имеют значение false. Если это свойство имеет значение false, элемент формы содержит недопустимые данные и, по крайней мере, одно из других свойств имеет значение true.

readonly boolean valueMissing

Элемент формы пуст, хотя он должен быть заполнен.