Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLInputElement.validity — stanje veljavnosti vnosnega polja

HTMLInputElement.validity razkriva trenutno stanje preverjanja omejitev vnosnega polja kot objekt ValidityState. Njegove zastavice označujejo posamezne težave, valid pa pove, ali ni nastavljena nobena zastavica napake.

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.validity
input.validity.valid
input.validity.valueMissing

HTMLInputElement.validity je lastnost samo za branje, ki vrne živ objekt ValidityState: shranjeni sklic odraža poznejše spremembe vnosnega polja. Tudi njegove zastavice so samo za branje. Ta API brskalnika določa HTML, ne ECMAScript; sama razpoložljivost Node.js ne zagotavlja podpore zanj.

valueMissing označuje manjkajočo obvezno vrednost, typeMismatch obliko, ki ni ustrezna vrsti, patternMismatch pa neskladje z pattern. Druge zastavice napak so tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput in customError. Njihova uporabnost je odvisna od vrste polja in omejitev. valid je true, kadar so vse zastavice napak false.

Branje validity ne prikaže sporočila in ne sproži dogodka invalid. checkValidity() preveri kontrolnik in lahko sproži invalid; reportValidity() lahko težavo tudi prikaže uporabniku. willValidate določa sodelovanje pri preverjanju: onemogočeno vnosno polje ima lahko še vedno zastavice napak, čeprav pri preverjanju ne sodeluje.

setCustomValidity('Blocked') nastavi customError; izbrišite ga z setCustomValidity(''). Samo popravek vrednosti napake ne izbriše. Primer prikazuje posodobitve prek shranjenega objekta state, ne da bi znova prebral input.validity. Preverjanje v brskalniku ne nadomesti preverjanja podatkov na strežniku.

Primeri

const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;

console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);

Rezultat

true false
false true
true false
false true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri