Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLInputElement.setCustomValidity — prilagođena pogreška validacije

HTMLInputElement.setCustomValidity postavlja ili briše prilagođenu pogrešku polja obrasca. Prazan niz briše tu pogrešku, ali ne isključuje druga ograničenja.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

input.setCustomValidity(message)

HTMLInputElement.setCustomValidity metoda je API-ja preglednika za validaciju obrazaca, definirana standardom HTML Living Standard, a ne ECMAScriptom. Podržavaju je aktualni preglednički mehanizmi; prisutnost Nodea 24 ne dokazuje dostupnost ovog API-ja.

Poziv input.setCustomValidity(message) s nepraznim nizom postavlja input.validity.customError na true. Prosljeđivanje vrijednosti "" briše samo prilagođenu pogrešku: ograničenja poput required i dalje vrijede. Metoda vraća undefined, a ne rezultat validacije.

Sama metoda ne prikazuje poruku. checkValidity() provjerava valjanost bez prikaza obavijesti o pogrešci. Ako polje ne prođe validaciju, reportValidity() vraća false, a preglednik obavještava korisnika o problemu samo ako događaj invalid nije otkazan. Otkazivanje događaja ne mijenja povratnu vrijednost. Elementi izuzeti iz validacije mogu zadržati prilagođenu pogrešku iako ne blokiraju validirano slanje obrasca.

Nakon promjene vrijednosti ponovno izračunajte pravilo i izričito uklonite zastarjelu pogrešku, obično u rukovatelju događaja input. U primjeru završni false false znači da nema prilagođene pogreške, ali uvjet required nije zadovoljen. Validacija na strani klijenta ne zamjenjuje validaciju na strani poslužitelja.

Primjeri

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());

Rezultat

true false
false true
false false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori