ValidityState
Baseline 2023
Newly available
Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Интерфейс ValidityState
представляет состояния валидности, в которых может находиться элемент при валидации ограничений. Вместе они помогают понять, по какой именно причине значение элемента не прошло валидацию.
Свойства
Если свойство возвращает true
, значит оно отражает причину, по которой значение не прошло валидацию. Исплючением является лишь свойство valid
, которое возвращает true
, когда значение элемента соответствует всем ограничениям.
badInput
Только для чтения-
Boolean
true
, если пользователь ввёл значение, которое браузер не может преобразовать. customError
Только для чтения-
Boolean
, указывающий, было ли установлено кастомное сообщение валидации путём вызова методаsetCustomValidity()
(en-US) с непустой строкой в аргументе. 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
(en-US) илиHTMLTextAreaElement
(en-US).false
, если длина меньше или равна максимальной длине. Примечание: Данное свойство никогда не будетtrue
в Gecko, потому что значению элемента не разрешается быть большеmaxlength
. Еслиtrue
, элемент соответствует CSS-псевдоклассам:invalid
и:out-of-range
. tooShort
Только для чтения-
Boolean
true
, если длина значения не достигает минимума, указанного в атрибутеminlength
объектовHTMLInputElement
(en-US) иHTMLTextAreaElement
(en-US).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
(en-US) Только для чтения-
Boolean
true
, если у элемента есть атрибутrequired
, но сам элемент заполнен не был.false
, если элемент был заполнен. Еслиtrue
, элемент соответствует CSS-псевдоклассу:invalid
.
Спецификации
Specification |
---|
HTML Standard # the-constraint-validation-api:validitystate-3 |
Совместимость с браузерами
BCD tables only load in the browser