HTMLButtonElement : propriété validity

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La propriété en lecture seule validity de l'interface HTMLButtonElement retourne un objet ValidityState qui représente les états de validité de cet élément.

L'exemple suivant montre qu'un <button> est dans un état invalide lorsque customError est définie ; dans cet état, la propriété valid de validityState vaut false, tandis que checkValidity() retourne true si le type du bouton n'est pas "submit", car ces boutons ne sont pas candidats à la validation de contrainte.

const button = document.getElementById("myButton");
button.setCustomValidity("Ce bouton est invalide.");
const validityState = button.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(button.checkValidity()); // false si le bouton est de type "submit", true sinon