CKTIS / JavaScript
HTMLInputElement.setCustomValidity — vlastná chyba validácie
HTMLInputElement.setCustomValidity nastavuje alebo maže vlastnú chybu formulárového poľa. Prázdny reťazec túto chybu odstráni, ale nevypne ostatné obmedzenia.
Verzia: 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 je metóda rozhrania API na validáciu formulárov v prehliadači, definovaná štandardom HTML Living Standard, nie ECMAScriptom. Podporujú ju súčasné jadrá prehliadačov; prítomnosť Node 24 nedokazuje dostupnosť tohto API.
Volanie input.setCustomValidity(message) s neprázdnym reťazcom nastaví input.validity.customError na true. Odovzdanie "" odstráni iba vlastnú chybu: obmedzenia ako required naďalej platia. Metóda vracia undefined, nie výsledok validácie.
Samotná metóda nezobrazí žiadnu správu. checkValidity() skontroluje platnosť bez zobrazenia chybového hlásenia. Ak pole neprejde validáciou, reportValidity() vráti false a prehliadač upozorní používateľa na problém len vtedy, ak udalosť invalid nebola zrušená. Zrušenie udalosti nemení návratovú hodnotu. Prvky vylúčené z validácie si môžu vlastnú chybu ponechať, hoci neblokujú validované odoslanie formulára.
Po zmene hodnoty znova vyhodnoťte pravidlo a zastaranú chybu výslovne odstráňte, zvyčajne v obsluhe udalosti input. V príklade záverečné false false znamená, že vlastná chyba nie je nastavená, ale podmienka required nie je splnená. Validácia na strane klienta nenahrádza validáciu na strane servera.
Prí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ýsledok
true false false true false false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.