ElementInternals: Gültigkeits-Eigenschaft

Die schreibgeschützte validity-Eigenschaft der ElementInternals-Schnittstelle gibt ein ValidityState-Objekt zurück, das die verschiedenen Gültigkeitszustände darstellt, in denen sich das Element im Hinblick auf die Validierung von Einschränkungen befinden kann.

Wert

Ein ValidityState-Objekt.

Ausnahmen

NotSupportedError DOMException

Wird ausgelöst, wenn das Element nicht die formAssociated-Eigenschaft auf true gesetzt hat.

Beispiele

Das folgende Beispiel zeigt eine benutzerdefinierte Checkbox-Komponente mit formAssociated auf true gesetzt. Der Wert von validity.valid wird in der Konsole protokolliert.

class CustomCheckbox extends HTMLElement {
 static formAssociated = true;
 constructor() {
 super();
 this.internals_ = this.attachInternals();
 }
 // ...
}
window.customElements.define("custom-checkbox", CustomCheckbox);
let element = document.getElementById("custom-checkbox");
console.log(element.internals_.validity.valid);

Spezifikationen

Browser-Kompatibilität