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.