CKTIS / JavaScript
ValidityState.valid — validade global do controlo
ValidityState.valid é uma propriedade booleana só de leitura: tem o valor true quando nenhum dos indicadores de erro de validação do controlo está definido.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
element.validity.validValidityState.valid, acessível através de element.validity.valid, tem o valor true quando todos os outros indicadores de erro em ValidityState têm o valor false. Esta é uma API do navegador definida pelo HTML Standard, não uma funcionalidade de uma edição específica do ECMAScript.
O objeto validity é atualizado em tempo real. No exemplo, o campo obrigatório vazio é inválido; introduzir Ada elimina o erro de valor em falta. Uma mensagem não vazia em setCustomValidity() define um erro personalizado; setCustomValidity('') elimina-o.
Ler valid não apresenta uma mensagem nem dispara invalid. Também não significa que o controlo participe na validação: willValidate indica se está elegível. checkValidity() tem em conta essa elegibilidade, enquanto reportValidity() também pode apresentar o problema.
Exemplos
const input = document.createElement('input');
input.required = true;
const state = input.validity;
console.log(state.valid);
input.value = 'Ada';
console.log(state.valid);
input.setCustomValidity('Rejected');
console.log(state.valid);
input.setCustomValidity('');
console.log(state.valid);Resultado
false true false true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.