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 des HTMLButtonElement Interfaces gibt einen boolean Wert zurück, der anzeigt, ob das Element die auf es angewendeten Einschränkungsvalidierungsregeln erfüllt. Wenn false, löst die Methode auch ein invalid Ereignis auf dem Element aus. Da es kein standardmäßiges Browserverhalten für checkValidity() gibt, hat das Abbrechen dieses invalid Ereignisses keine Wirkung. Es gibt immer true zurück, wenn der type des <button> Elements "button" oder "reset" ist, da solche Buttons 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 die CSS :invalid Pseudoklasse zugeordnet und wird dazu führen, dass checkValidity() false zurückgibt. Verwenden Sie die Methode HTMLButtonElement.setCustomValidity(), um die HTMLButtonElement.validationMessage auf den leeren String zu setzen, um den validity Zustand als gültig zu setzen.

Syntax

js
checkValidity()

Parameter

Keine.

Rückgabewert

Gibt true zurück, wenn der Wert des Elements keine Gültigkeitsprobleme hat; andernfalls wird false zurückgegeben.

Beispiele

Im folgenden Beispiel gibt der Aufruf von checkValidity() entweder true oder false zurück.

js
const element = document.getElementById("myButton");
console.log(element.checkValidity());

Spezifikationen

Specification
HTML Standard
# dom-cva-checkvalidity-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch