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 por setCustomValidity() 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 atributo max.

ValidityState.rangeUnderflow (en-US) Somente leitura

É um Boolean informando se o valor é menor do que o mínimo especificado pelo atributo min.

ValidityState.stepMismatch (en-US) Somente leitura

É um Boolean informando se o valor não segue a regra definida pelo atributo step.

ValidityState.tooLong (en-US) Somente leitura

É um Boolean informando se o valor ultrapassa o especificado pelo atributo maxlength para HTMLInputElement ou HTMLTextAreaElement (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 em maxlength.

ValidityState.tooShort (en-US) Somente leitura

É um Boolean informando se o valor não corresponde ao especificado no atributo minlength para HTMLInputElement ou HTMLTextAreaElement (en-US).

ValidityState.typeMismatch (en-US) Somente leitura

É um Boolean informando se o valor não corresponde ao tipo de entrada definida. (Um exemplo é quando type é email ou url).

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 atributo required, mas não tem value.

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

Veja também