KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLInputElement.setCustomValidity — een aangepaste validatiefout

HTMLInputElement.setCustomValidity stelt de aangepaste fout van een formulierveld in of wist die. Een lege tekenreeks wist die fout, maar schakelt andere beperkingen niet uit.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

input.setCustomValidity(message)

HTMLInputElement.setCustomValidity is een methode van de browser-API voor formuliervalidatie, gedefinieerd door de HTML Living Standard en niet door ECMAScript. De methode wordt ondersteund in huidige browser-engines; de aanwezigheid van Node 24 bewijst niet dat deze API beschikbaar is.

Een aanroep van input.setCustomValidity(message) met een niet-lege tekenreeks stelt input.validity.customError in op true. Het doorgeven van "" wist alleen de aangepaste fout: beperkingen zoals required blijven gelden. De methode retourneert undefined, geen validatieresultaat.

De methode zelf toont geen melding. checkValidity() controleert de geldigheid zonder een foutmelding te tonen. Als het veld niet door de validatie komt, retourneert reportValidity() false en meldt de browser het probleem alleen aan de gebruiker als het invalid-event niet wordt geannuleerd. Het annuleren van het event verandert de retourwaarde niet. Elementen die van validatie zijn uitgesloten, kunnen een aangepaste fout behouden, ook als ze een gevalideerde formulierverzending niet blokkeren.

Bereken na een waardewijziging de regel opnieuw en wis expliciet een verouderde fout, meestal in een handler voor het input-event. In het voorbeeld betekent de laatste false false dat er geen aangepaste fout is, maar dat niet aan required wordt voldaan. Validatie aan de clientzijde vervangt validatie aan de serverzijde niet.

Voorbeelden

const input = document.createElement("input");
input.required = true;
input.value = "admin";

function validate() {
  input.setCustomValidity(
    input.value === "admin" ? "Reserved name." : ""
  );
}

validate();
console.log(input.validity.customError, input.checkValidity());

input.value = "alex";
validate();
console.log(input.validity.customError, input.checkValidity());

input.value = "";
validate();
console.log(input.validity.customError, input.checkValidity());

Resultaat

true false
false true
false false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen