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 anzugeben, dass das Element keinen benutzerdefinierten Validierungsfehler hat.

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, aber sie setzt 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 Validierungsfehler.

Rückgabewert

Keiner (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