CKTIS / JavaScript
HTMLInputElement.setCustomValidity — lastna napaka preverjanja
HTMLInputElement.setCustomValidity nastavi ali izbriše lastno napako polja obrazca. Prazen niz to napako izbriše, vendar ne izklopi drugih omejitev.
Različica: 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 je metoda brskalniškega API-ja za preverjanje obrazcev, ki jo določa HTML Living Standard, ne pa ECMAScript. Podpirajo jo sodobna jedra brskalnikov; prisotnost Node 24 ne dokazuje, da je ta API na voljo.
Klic input.setCustomValidity(message) z nepraznim nizom nastavi input.validity.customError na true. Če podate "", izbrišete samo lastno napako: omejitve, kot je required, še vedno veljajo. Metoda vrne undefined, ne rezultata preverjanja.
Metoda sama ne prikaže sporočila. checkValidity() preveri veljavnost brez prikaza obvestila o napaki. Če polje ne prestane preverjanja, reportValidity() vrne false, brskalnik pa uporabnika opozori na težavo le, če dogodek invalid ni preklican. Preklic dogodka ne spremeni vrnjene vrednosti. Elementi, izvzeti iz preverjanja, lahko ohranijo lastno napako, čeprav ne preprečijo preverjene oddaje obrazca.
Po spremembi vrednosti znova izračunajte pravilo in izrecno izbrišite zastarelo napako, običajno v obravnavalniku dogodka input. V primeru končni false false pomeni, da ni lastne napake, vendar pogoj required ni izpolnjen. Preverjanje na strani odjemalca ne nadomesti preverjanja na strani strežnika.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.