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.
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/pt-br/web/api/html_dom_api/index.md)
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
Specification |
---|
HTML Standard # the-constraint-validation-api:validitystate-3 |
Compatibilidade com navegadores
BCD tables only load in the browser