Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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
# dom-elementinternals-validity

Browser-Kompatibilität