ElementInternals: checkValidity() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
Die checkValidity() Methode der ElementInternals-Schnittstelle überprüft, ob das Element alle darauf angewendeten Constraint-Validierung Regeln erfüllt.
Wenn checkValidity false zurückgibt, wird ein abbrechbares ungültiges Ereignis auf dem Element ausgelöst.
Syntax
checkValidity()
Parameter
Keine.
Rückgabewert
Ein boolescher Wert, true, wenn das Element alle Validierungsbeschränkungen erfüllt.
Ausnahmen
NotSupportedErrorDOMException-
Wird ausgelöst, wenn das Element seine
formAssociated-Eigenschaft nicht auftruegesetzt hat.
Beispiele
Im folgenden Beispiel wird ElementInternals.setValidity() verwendet, um anzuzeigen, dass das Element die Validierungsregeln nicht erfüllt. Beim Aufruf von checkValidity() wird false zurückgegeben. Nach einem erneuten Aufruf von setValidity, diesmal mit der Angabe, dass alle Regeln falsch markiert sind, gibt checkValidity() true zurück.
let element = document.getElementById("join-checkbox");
element.internals_.setValidity({ valueMissing: true }, "my message");
console.log(element.internals_.checkValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.checkValidity()); // true
Spezifikationen
| Specification |
|---|
| HTML # dom-elementinternals-checkvalidity |
Browser-Kompatibilität
Loading…