Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje