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 willValidate schreibgeschützte Eigenschaft des ElementInternals-Interfaces gibt true zurück, wenn das Element ein einreichbares Element ist, das ein Kandidat für die Einschränkungsvalidierung ist.

Elemente, die von der Kandidatur für die Einschränkungsvalidierung ausgeschlossen sind, umfassen diejenigen, die die Attribute disabled, hidden oder readonly haben, 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, andernfalls false.

Ausnahmen

NotSupportedError DOMException

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 die 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_.willValidate); // true

Spezifikationen

Specification
HTML Standard
# dom-elementinternals-willvalidate

Browser-Kompatibilität

BCD tables only load in the browser