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.