Spec-Zone.ru › Web APIs

ValidityState

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с декабря 2018 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Интерфейс ValidityState представляет собой состояния валидности, в которых может находиться элемент с точки зрения проверки ограничений. Вместе они помогают объяснить, почему значение элемента не прошло валидацию, если оно не является допустимым.

Свойства экземпляра

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

badInput Только для чтения

Булевое значение, равное true, если пользователь ввёл данные, которые браузер не может преобразовать.

customError Только для чтения

Булевое значение, указывающее, установлено ли пользовательское сообщение об ошибке элемента на непустую строку путём вызова метода setCustomValidity() элемента.

patternMismatch Только для чтения

Булевое значение, равное true, если значение не соответствует указанному pattern, и false, если соответствует. Если true, элемент соответствует псевдоклассу CSS :invalid.

rangeOverflow Только для чтения

Булевое значение, равное true, если значение больше максимального, указанного атрибутом max, или false, если оно меньше или равно максимальному. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

rangeUnderflow Только для чтения

Булевое значение, равное true, если значение меньше минимального, указанного атрибутом min, или false, если оно больше или равно минимальному. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

stepMismatch Только для чтения

Булевое значение, равное true, если значение не соответствует правилам, определённым атрибутом step (то есть оно не делится нацело на значение шага), или false, если оно соответствует правилу шага. Если true, элемент соответствует псевдоклассу CSS :invalid.

tooLong Только для чтения

Булевое значение, равное true, если значение превышает указанную maxlength для объектов HTMLInputElement или HTMLTextAreaElement, или false, если его длина меньше или равна максимальной длине. Примечание: Это свойство никогда не true в Gecko, так как значения элементов не могут быть длиннее maxlength. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

tooShort Только для чтения

Булевое значение, равное true, если значение не соответствует указанной minlength для объектов HTMLInputElement или HTMLTextAreaElement, или false, если его длина больше или равна минимальной длине. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

typeMismatch Только для чтения

Булевое значение, равное true, если значение не имеет требуемого синтаксиса (когда type равно email или url), или false, если синтаксис верен. Если true, элемент соответствует псевдоклассу CSS :invalid.

valid Только для чтения

Булевое значение, равное true, если элемент соответствует всем ограничениям проверки, и, следовательно, считается допустимым, или false, если он не удовлетворяет каким-либо ограничениям. Если true, элемент соответствует псевдоклассу CSS :valid; в противном случае, псевдоклассу :invalid.

valueMissing Только для чтения

Булевое значение, равное true, если у элемента есть атрибут required, но нет значения, или false в противном случае. Если true, элемент соответствует псевдоклассу CSS :invalid.

Спецификации

Спецификация
HTML
# the-constraint-validation-api:validitystate-3

Совместимость с браузерами

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
ValidityState 4 12 4 12.1 5 18 4 12.1 5 1.0 4
badInput 25 12 29 15 7 25 64 14 7 1.5 4.4
customError 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
patternMismatch 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
rangeOverflow 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
rangeUnderflow 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
stepMismatch 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
tooLong 4
12Не поддерживается в маловероятном случае, если значение изначально установлено слишком долго, а затем изменено пользователем в всё ещё неправильное состояние. Согласно caniuse.com.
4Не поддерживается в маловероятном случае, если значение изначально установлено слишком долго, а затем изменено пользователем в всё ещё неправильное состояние. Согласно caniuse.com.
12.1 5 18 64 12.1 5 1.0 4
tooShort 40 17 51 27 10 40 64 27 10 4.0 67
typeMismatch 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
valid 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37
valueMissing 4 12 4 12.1 5 18 4 12.1 5 1.0 ≤37

См. также

  • Руководство: Валидация ограничений
  • Учебник: Валидация данных форм

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ValidityState

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API