ElementInternals: Gültigkeits-Eigenschaft

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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.

js
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

Specification
HTML Standard
# dom-elementinternals-validity

Browser-Kompatibilität

BCD tables only load in the browser