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 December 2018.
Die setCustomValidity()
Methode des HTMLOutputElement
-Interfaces legt die benutzerdefinierte Fehlermeldung für das <output>
-Element fest. Verwenden Sie den leeren String, um anzugeben, dass das Element keinen benutzerdefinierten Fehler aufweist.
Das <output>
-Element ist kein Kandidat für die Eingabekontrolle. 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 Fehler.
Rückgabewert
Keiner (undefined
).
Beispiele
In diesem Beispiel setzen wir eine benutzerdefinierte Fehlermeldung, wenn der value
des <output>
kein Nicht-Null-Zahl ist. Wenn es eine Zahl ist, 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 Standard # dom-cva-setcustomvalidity-dev |
Browser-Kompatibilität
BCD tables only load in the browser