ValidityState
A interface ValidityState
representa os estados de validação que um elemento
pode conter de acordo com as propriedades de validação abaixo. Juntas, elas podem explicar porque um elemento é inválido (caso seja) ao ser validado.
Propriedades
Para cada uma das propriedades Booleanas abaixo, caso retorne true
, isso indica a razão específica porque a validação falhou, exceto no caso da propriedade valid, que retorna true
no caso do elemento ser completamente válido e false
caso contrário.
ValidityState.badInput
(en-US) Somente leitura-
É um
Boolean
informando se o usuário inseriu um valor que o navegador é incapaz de converter. ValidityState.customError
Somente leitura-
É um
Boolean
informando se o elemento possui uma mensagem de validação definida porsetCustomValidity()
para um valor não vázio. ValidityState.patternMismatch
(en-US) Somente leitura-
É um
Boolean
informando se o valor não combina com o padrão (pattern
) especificado. ValidityState.rangeOverflow
(en-US) Somente leitura-
É um
Boolean
informando se o valor é maior do que o máximo especificado pelo atributomax
. ValidityState.rangeUnderflow
(en-US) Somente leitura-
É um
Boolean
informando se o valor é menor do que o mínimo especificado pelo atributomin
. ValidityState.stepMismatch
(en-US) Somente leitura-
É um
Boolean
informando se o valor não segue a regra definida pelo atributostep
. ValidityState.tooLong
(en-US) Somente leitura-
É um
Boolean
informando se o valor ultrapassa o especificado pelo atributomaxlength
paraHTMLInputElement
ouHTMLTextAreaElement
(en-US). OBS: Isso nunca serátrue
em navegadores como o Firefox, pois a inserção de valores não é permitida ao alcançar o valor definido emmaxlength
. ValidityState.tooShort
(en-US) Somente leitura-
É um
Boolean
informando se o valor não corresponde ao especificado no atributominlength
paraHTMLInputElement
ouHTMLTextAreaElement
(en-US). ValidityState.typeMismatch
(en-US) Somente leitura-
É um
Boolean
informando se o valor não corresponde ao tipo de entrada definida. (Um exemplo é quandotype
éemail
ouurl
). ValidityState.valid
Somente leitura-
É um
Boolean
informando se o elemento é completamente válido. ValidityState.valueMissing
(en-US) Somente leitura-
É um
Boolean
informando que o elemento tem o atributorequired
, mas não temvalue
.
Especificações
Specification |
---|
HTML Standard # the-constraint-validation-api:validitystate-3 |
Compatibilidade com navegadores
BCD tables only load in the browser