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