HTMLButtonElement: Methode setCustomValidity()
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 setCustomValidity() der Schnittstelle HTMLButtonElement legt die benutzerdefinierte Validitätsmeldung für das Element <button> fest. Verwenden Sie eine leere Zeichenfolge, um anzugeben, dass das Element keinen benutzerdefinierten Validitätsfehler aufweist.
Einige <button>-Elemente unterliegen nicht der Constraint Validation (siehe HTMLButtonElement.willValidate). Bei diesen Buttons bewirkt die Methode reportValidity() nicht, dass die benutzerdefinierte Fehlermeldung angezeigt wird. Sie setzt jedoch die Eigenschaft customError des ValidityState-Objekts des Elements auf true und die Eigenschaft valid auf false. Mit HTMLButtonElement.willValidate können Sie prüfen, ob ein Button an der Constraint Validation teilnimmt.
Syntax
setCustomValidity(string)
Parameter
string-
Die Zeichenfolge mit der Fehlermeldung. Eine leere Zeichenfolge entfernt alle benutzerdefinierten Validitätsfehler.
Rückgabewert
Keiner (undefined).
Beispiele
const errorButton = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
errorButton.setCustomValidity("There is an error");
} else {
errorButton.setCustomValidity("");
}
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-cva-setcustomvalidity-dev |