ElementInternals: willValidate-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
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
NotSupportedErrorDOMException-
Wird ausgelöst, wenn das Element seine
formAssociated-Eigenschaft nicht auftruegesetzt 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
| Spezifikation |
|---|
| HTML # dom-elementinternals-willvalidate |