ValidityState
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.
Интерфейс ValidityState
представляет состояния валидности, в которых может находиться элемент при валидации ограничений. Вместе они помогают понять, по какой именно причине значение элемента не прошло валидацию.
Свойства
Если свойство возвращает true
, значит оно отражает причину, по которой значение не прошло валидацию. Исплючением является лишь свойство valid
, которое возвращает true
, когда значение элемента соответствует всем ограничениям.
badInput
Только для чтения-
Boolean
true
, если пользователь ввёл значение, которое браузер не может преобразовать. customError
Только для чтения-
Boolean
, указывающий, было ли установлено кастомное сообщение валидации путём вызова методаsetCustomValidity()
с непустой строкой в аргументе. patternMismatch
Только для чтения-
Boolean
true
, если значение не соответствует шаблону, указанному в атрибутеpattern
.false
, если значение соответствует этому шаблону. Еслиtrue
, элемент соответствует CSS-псевдоклассу:invalid
. rangeOverflow
Только для чтения-
Boolean
true
, если значение больше максимума, заданного в атрибутеmax
.false
, если значение меньше или равно ему. Еслиtrue
, элемент соответствует CSS-псевдоклассам:invalid
и:out-of-range
. rangeUnderflow
Только для чтения-
Boolean
true
, если значение меньше минимума, заданного в атрибутеmin
.false
, если значение больше или равно ему. Еслиtrue
, элемент соответствует CSS-псевдоклассам:invalid
и:out-of-range
. stepMismatch
Только для чтения-
Boolean
true
, если значение не соответствует правилам, заданным в атрибутеstep
(то есть, не делится без остатка на значение шага).false
, если соответствует этим правилам. Еслиtrue
, элемент соответствует CSS-псевдоклассам:invalid
и:out-of-range
. tooLong
Только для чтения-
Boolean
true
, если значение превышает лимит, указанный в атрибутеmaxlength
объектовHTMLInputElement
илиHTMLTextAreaElement
.false
, если длина меньше или равна максимальной длине. Примечание: Данное свойство никогда не будетtrue
в Gecko, потому что значению элемента не разрешается быть большеmaxlength
. Еслиtrue
, элемент соответствует CSS-псевдоклассам:invalid
и:out-of-range
. tooShort
Только для чтения-
Boolean
true
, если длина значения не достигает минимума, указанного в атрибутеminlength
объектовHTMLInputElement
иHTMLTextAreaElement
.false
, если длина больше или равна ему. Еслиtrue
, элемент соответствует CSS-псевдоклассам:invalid
и:out-of-range
. typeMismatch
Только для чтения-
Boolean
true
, если значение не соответствует требуемому синтаксису (когда дляtype
задано значениеemail
илиurl
).false
, если синтаксис корректный. Еслиtrue
, элемент соответствует CSS-псевдоклассу:invalid
. valid
Только для чтения-
Boolean
true
, если элемент соответствует всем ограничениям валидации и, следовательно, считается валидным.false
, если не соответствует любому ограничению. Еслиtrue
, элемент соответствует CSS-псевдоклассу:valid
; иначе — псевдоклассу:invalid
. valueMissing
Только для чтения-
Boolean
true
, если у элемента есть атрибутrequired
, но сам элемент заполнен не был.false
, если элемент был заполнен. Еслиtrue
, элемент соответствует CSS-псевдоклассу:invalid
.
Спецификации
Specification |
---|
HTML Standard # the-constraint-validation-api:validitystate-3 |
Совместимость с браузерами
BCD tables only load in the browser