HTMLOutputElement: setCustomValidity() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit August 2016 browserübergreifend verfügbar.
Die setCustomValidity() Methode der HTMLOutputElement Schnittstelle setzt die benutzerdefinierte Fehlermeldung für das <output> Element. Verwenden Sie den leeren String, um anzugeben, dass das Element keinen benutzerdefinierten Gültigkeitsfehler hat.
Das <output> Element ist kein Kandidat für die Einschränkungsvalidierung. Die reportValidity() Methode wird nicht dazu führen, dass die benutzerdefinierte Fehlermeldung dem Benutzer angezeigt wird, setzt jedoch die customError Eigenschaft des ValidityState Objekts des Elements auf true und die valid Eigenschaft auf false.
Syntax
setCustomValidity(string)
Parameter
string-
Der String, der die Fehlermeldung enthält. Der leere String entfernt alle benutzerdefinierten Gültigkeitsfehler.
Rückgabewert
Keiner (undefined).
Beispiele
In diesem Beispiel setzen wir eine benutzerdefinierte Fehlermeldung, wenn der value des <output> Elements keine ungleich null Zahl ist. Wenn es sich um eine Zahl handelt, setzen wir den benutzerdefinierten Fehler auf einen leeren String:
const cart = document.getElementById("cart-form");
const total = cart.elements("total");
if (parseFloat(total.value)) {
errorOutput.setCustomValidity("");
} else {
errorOutput.setCustomValidity("There is an error");
}
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-cva-setcustomvalidity-dev |