CKTIS / JavaScript
HTMLInputElement.setCustomValidity — vlastní chyba validace
HTMLInputElement.setCustomValidity nastavuje nebo maže vlastní chybu formulářového pole. Prázdný řetězec tuto chybu odstraní, ale nevypne ostatní omezení.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.setCustomValidity(message)HTMLInputElement.setCustomValidity je metoda rozhraní API pro validaci formulářů v prohlížeči, definovaná standardem HTML Living Standard, nikoli ECMAScriptem. Podporují ji současná jádra prohlížečů; přítomnost Node 24 nedokládá, že je toto API dostupné.
Volání input.setCustomValidity(message) s neprázdným řetězcem nastaví input.validity.customError na true. Předání "" odstraní pouze vlastní chybu: omezení jako required platí dál. Metoda vrací undefined, nikoli výsledek validace.
Samotná metoda žádnou zprávu nezobrazí. checkValidity() ověří platnost bez zobrazení chybového hlášení. Pokud pole neprojde validací, reportValidity() vrátí false a prohlížeč upozorní uživatele na problém jen tehdy, pokud událost invalid nebyla zrušena. Zrušení události nemění návratovou hodnotu. Prvky vyřazené z validace si mohou vlastní chybu ponechat, i když neblokují validované odeslání formuláře.
Po změně hodnoty znovu vyhodnoťte pravidlo a zastaralou chybu výslovně odstraňte, obvykle v obsluze události input. V příkladu závěrečné false false znamená, že není přítomna vlastní chyba, ale podmínka required není splněna. Validace na straně klienta nenahrazuje validaci na straně serveru.
Příklady
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());Výsledek
true false false true false false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.