HTMLButtonElement: `validity`-Eigenschaft

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.

Die schreibgeschützte validity-Eigenschaft des HTMLButtonElement-Interfaces gibt ein ValidityState-Objekt zurück, das die Validitätszustände darstellt, in denen sich dieses Element befindet.

Wert

Ein ValidityState-Objekt.

Beispiele

Das folgende Beispiel zeigt, dass ein <button> in einem ungültigen Zustand ist, wenn ein customError gesetzt ist; in diesem Zustand ist die validity-Eigenschaft des validityState false, während checkValidity() true zurückgibt, wenn der type des Buttons nicht "submit" ist, da solche Buttons keine Kandidaten für die Constraint-Validierung sind.

js
const button = document.getElementById("myButton");
button.setCustomValidity("This button is invalid.");
const validityState = button.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(button.checkValidity()); // false if the button is of the "submit" type, true otherwise

Spezifikationen

Specification
HTML Standard
# the-constraint-validation-api:dom-cva-validity

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch