HTMLButtonElement: 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 December 2018.
Die checkValidity()-Methode der Schnittstelle HTMLButtonElement gibt einen booleschen Wert zurück, der anzeigt, ob das Element alle darauf angewendeten Einschränkungsvalidierungsregeln erfüllt. Wenn der Wert false ist, wird außerdem ein invalid-Ereignis auf dem Element ausgelöst. Da es kein Standardverhalten des Browsers für checkValidity() gibt, hat das Abbrechen dieses invalid-Ereignisses keine Auswirkung. Es gibt immer true zurück, wenn der type des <button>-Elements "button" oder "reset" ist, da solche Schaltflächen nie Kandidaten für Einschränkungsvalidierung sind.
Hinweis:
Ein HTML-<button>-Element des Typs "submit" mit einer nicht-null validationMessage gilt als ungültig, wird mit der CSS-:invalid-Pseudoklasse übereinstimmen und checkValidity() wird false zurückgeben. Verwenden Sie die Methode HTMLButtonElement.setCustomValidity(), um die HTMLButtonElement.validationMessage auf einen leeren String zu setzen, um den validity-Zustand auf gültig zu setzen.
Syntax
checkValidity()
Parameter
Keine.
Rückgabewert
Gibt true zurück, wenn der Wert des Elements keine Validitätsprobleme hat; 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
| Specification |
|---|
| HTML # dom-cva-checkvalidity-dev |