HTMLFieldSetElement: 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 der HTMLFieldSetElement-Schnittstelle setzt die benutzerdefinierte Fehlermeldung für das <fieldset>-Element. Verwenden Sie den leeren String, um anzuzeigen, dass das Element keinen benutzerdefinierten Gültigkeitsfehler aufweist.

Das <fieldset>-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

js
setCustomValidity(string)

Parameter

string

Der String, der die Fehlermeldung enthält. Der leere String entfernt alle benutzerdefinierten Gültigkeitsfehler.

Rückgabewert

Keine (undefined).

Beispiele

js
const errorFieldSet = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
  errorFieldSet.setCustomValidity("There is an error");
} else {
  errorFieldSet.setCustomValidity("");
}

Spezifikationen

Specification
HTML Standard
# dom-cva-setcustomvalidity-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch