CKTIS / JavaScript
ValidityState: celková platnosť a príčiny chýb
Pomocou `element.validity` rozlíšiš platné pole od chýbajúcej povinnej hodnoty, nesprávneho formátu alebo príliš krátkej hodnoty zadanej používateľom.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;element.validity vracia objekt ValidityState pre formulárový prvok. Jeho booleovské vlastnosti sú iba na čítanie a odrážajú aktuálny stav: uložený odkaz na objekt nie je snímkou stavu. Ide o rozhranie webovej platformy, nie o súčasť ECMAScriptu.
valid je true, len ak nie je nastavený žiadny príznak chyby vrátane tých, ktoré tu nie sú opísané, napríklad customError. Viacero príznakov môže byť true naraz. valueMissing je true, keď chýba hodnota vyžadovaná atribútom required, napríklad pri prázdnom povinnom e-mailovom poli.
typeMismatch je true, ak neprázdna hodnota nespĺňa pravidlá syntaxe HTML pre type="email" alebo type="url". Pri e-maile umožňuje multiple zoznam adries oddelených čiarkami. Prázdne povinné e-mailové pole má valueMissing, nie typeMismatch. Kontrola syntaxe nepotvrdzuje, že adresa existuje.
tooShort je true, ak pre input alebo textarea platí minlength, je nastavený príznak zmeny hodnoty (dirty value flag), hodnotu naposledy zmenil používateľ a neprázdna hodnota sprístupnená cez API má menej kódových jednotiek UTF-16, ako stanovuje minimum. Samotné minlength nerobí pole povinným. Priradenie do .value chybu nevyvolá, ani keď potom zavoláš checkValidity() alebo reportValidity().
Pomocou valid zisti celkový stav poľa a podľa príznakov chýb vyber vhodnú správu. Odoslané údaje znova validuj na serveri: validácia v prehliadači sa dá obísť.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ValidityState example</title>
</head>
<body>
<label for="email">Email:</label>
<input id="email" type="email" required minlength="8" autocomplete="off">
<button type="button">Next</button>
<script>
(() => {
const input = document.getElementById('email');
const state = input.validity;
const log = (step) => console.log([
step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
].join(' '));
input.value = '';
log('empty');
input.value = 'not-an-email';
log('wrong-format');
input.value = 'a@b.co';
log('scripted-short');
input.value = '';
input.addEventListener('change', () => log('user-short'), { once: true });
})();
</script>
</body>
</html>Výsledok
empty false true false false wrong-format false false true false scripted-short true false false false user-short false false false true
Otvor príklad ako stránku HTML v prehliadači a sleduj výstup v konzole prehliadača. Po prvých troch riadkoch napíš do poľa `a@b.co` a stlač Tab. Za označením kroku nasledujú `valid`, `valueMissing`, `typeMismatch` a `tooShort`. Tá istá adresa so šiestimi kódovými jednotkami je v oboch prípadoch syntakticky platná, ale `minLength = 8` poruší až pri ručnom zadaní.
Súvisiace lekcie
- JavaScript · Lekcia 22 · Stredne pokročilá · Verzia: 3