HTMLOutputElement: setCustomValidity() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since August 2016.
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
| Specification |
|---|
| HTML # dom-cva-setcustomvalidity-dev |