ElementInternals: willValidate-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 Eigenschaft willValidate der ElementInternals-Schnittstelle gibt true zurück, wenn das Element ein übermittelbares Element ist, das ein Kandidat für die Einschränkungsvalidierung ist.

Elemente, die keine Kandidaten für die Einschränkungsvalidierung sein können, sind solche, die die Attribute disabled, hidden oder readonly besitzen, Eingabeelemente vom type=button oder type=reset, oder jedes Element, das ein <datalist>-Element ist oder einen <datalist>-Element-Vorfahren hat.

Wert

true, wenn das Element ein Kandidat für die Einschränkungsvalidierung ist, sonst false.

Ausnahmen

NotSupportedError DOMException: Wird ausgelöst, wenn das Element seine formAssociated-Eigenschaft nicht auf true gesetzt hat.

Beispiele

Das folgende Beispiel zeigt eine benutzerdefinierte Checkbox-Komponente mit formAssociated auf true gesetzt. Der Wert von willValidate 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_.willValidate); // true

Spezifikationen

This feature is defined in the following specifications:

HTML
# dom-elementinternals-willvalidate