HTMLButtonElement: Methode checkValidity()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode checkValidity() der Schnittstelle HTMLButtonElement gibt einen booleschen Wert zurück, der angibt, ob das Element die für es geltenden Regeln der Constraint Validation erfüllt. Ist der Rückgabewert false, löst die Methode außerdem ein invalid-Ereignis auf dem Element aus. Da es für checkValidity() kein Standardverhalten des Browsers gibt, hat das Abbrechen dieses invalid-Ereignisses keine Auswirkung. Die Methode gibt immer true zurück, wenn das <button>-Element nicht für die Constraint Validation infrage kommt (wenn sein willValidate false ist).
Hinweis:
Ein HTML-<button>-Element vom Typ "submit" mit einer validationMessage, die nicht null ist, gilt als ungültig, entspricht der CSS-Pseudoklasse :invalid und führt dazu, dass checkValidity() false zurückgibt. Verwenden Sie die Methode HTMLButtonElement.setCustomValidity(), um die HTMLButtonElement.validationMessage auf eine leere Zeichenfolge zu setzen und damit den Zustand validity auf gültig zu setzen.
Syntax
checkValidity()
Parameter
Keine.
Rückgabewert
Gibt true zurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist oder das Element nicht für die Constraint Validation infrage kommt; andernfalls false.
Beispiele
Im folgenden Beispiel gibt ein Aufruf von checkValidity() entweder true oder false zurück.
const element = document.getElementById("myButton");
console.log(element.checkValidity());
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-cva-checkvalidity-dev |