Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje