Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLInputElement.validity — stav platnosti vstupného poľa

HTMLInputElement.validity sprístupňuje aktuálny stav overovania obmedzení vstupného poľa ako objekt ValidityState. Jeho príznaky označujú konkrétne problémy a valid udáva, či nie je nastavený žiadny chybový príznak.

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

Syntax

input.validity
input.validity.valid
input.validity.valueMissing

HTMLInputElement.validity je vlastnosť iba na čítanie, ktorá vracia živý objekt ValidityState: uložený odkaz odráža neskoršie zmeny vstupného poľa. I jeho príznaky sú iba na čítanie. Toto rozhranie prehliadača definuje HTML, nie ECMAScript; samotná dostupnosť Node.js jeho podporu nezaručuje.

valueMissing označuje chýbajúcu povinnú hodnotu, typeMismatch formát nezodpovedajúci typu a patternMismatch nesúlad s pattern. Ďalšie chybové príznaky sú tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput a customError. To, či sa uplatnia, závisí od typu poľa a obmedzení. valid má hodnotu true, keď majú všetky chybové príznaky hodnotu false.

Čítanie validity nezobrazí správu ani nevyvolá invalid. checkValidity() overí ovládací prvok a môže vyvolať invalid; reportValidity() môže navyše používateľovi zobraziť problém. willValidate určuje účasť na overovaní: aj zakázané vstupné pole môže mať chybové príznaky, hoci sa na overovaní nezúčastňuje.

setCustomValidity('Blocked') nastaví customError; vymažete ho pomocou setCustomValidity(''). Samotná oprava hodnoty chybu nevymaže. Príklad ukazuje zmeny prostredníctvom uloženého objektu state bez opätovného čítania input.validity. Overovanie v prehliadači nenahrádza kontrolu údajov na serveri.

Príklady

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

Výsledok

true false
false true
true false
false true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje