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
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
Somente leitura- É um
Boolean
informando se o valor não combina com o padrão (pattern
) especificado. ValidityState.rangeOverflow
Somente leitura- É um
Boolean
informando se o valor é maior do que o máximo especificado pelo atributomax
. ValidityState.rangeUnderflow
Somente leitura- É um
Boolean
informando se o valor é menor do que o mínimo especificado pelo atributomin
. ValidityState.stepMismatch
Somente leitura- É um
Boolean
informando se o valor não segue a regra definida pelo atributostep
. ValidityState.tooLong
Somente leitura- É um
Boolean
informando se o valor ultrapassa o especificado pelo atributomaxlength
paraHTMLInputElement
ouHTMLTextAreaElement
. 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
Somente leitura- É um
Boolean
informando se o valor não corresponde ao especificado no atributominlength
paraHTMLInputElement
ouHTMLTextAreaElement
. ValidityState.typeMismatch
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
Somente leitura- É um
Boolean
informando que o elemento tem o atributorequired
, mas não temvalue
.
Especificações
Especificação | Status | Comentário |
---|---|---|
HTML Living Standard The definition of 'ValidityState' in that specification. |
Padrão em tempo real | Live Standard |
HTML 5.1 The definition of 'ValidityState' in that specification. |
Recomendação | No change from the previous snapshot HTML5. |
HTML5 The definition of 'ValidityState' in that specification. |
Recomendação | First snapshot of HTML Living Standard containing this interface. |
Compatibilidade com navegadores
BCD tables only load in the browser
A tabela de compatibilidade desta página é gerada a partir de dados estruturados. Se você gostaria de contribuir com estes dados, por favor, veja https://github.com/mdn/browser-compat-data e nos envie um pull request.