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

CKTIS / JavaScript

ValidityState: skupna veljavnost in vzroki napak

Z `element.validity` ločiš veljavno polje od manjkajoče obvezne vrednosti, napačne oblike ali prekratke vrednosti, ki jo je vnesel uporabnik.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

element.validity vrne objekt ValidityState za element obrazca. Njegove logične lastnosti so samo za branje in odražajo trenutno stanje: shranjena referenca ni posnetek stanja. To je API spletne platforme, ne del ECMAScripta.

valid je true samo, če ni nastavljena nobena zastavica napake, tudi tista, ki tu ni opisana, na primer customError. Več zastavic je lahko hkrati true. valueMissing je true, kadar manjka vrednost, ki jo zahteva required, na primer pri praznem obveznem polju za e-pošto.

typeMismatch je true, če neprazna vrednost ne ustreza pravilom skladnje HTML za type="email" ali type="url". Pri e-pošti multiple omogoča seznam naslovov, ločenih z vejicami. Prazno obvezno polje za e-pošto ima valueMissing, ne typeMismatch. Preverjanje skladnje ne potrdi, da naslov obstaja.

tooShort je true, če za input ali textarea velja minlength, je nastavljena zastavica spremembe vrednosti (dirty value flag), je vrednost nazadnje spremenil uporabnik in ima neprazna vrednost, ki jo poda API, manj kodnih enot UTF-16 od najmanjšega dovoljenega števila. Sam minlength ne naredi polja obveznega. Prireditev .value ne sproži te napake, niti če nato pokličeš checkValidity() ali reportValidity().

Z valid preveri skupno stanje polja, z zastavicami napak pa izberi ustrezno sporočilo. Poslane podatke znova preveri na strežniku: preverjanje v brskalniku je mogoče zaobiti.

Primeri

<!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>

Rezultat

empty false true false false
wrong-format false false true false
scripted-short true false false false
user-short false false false true

Odpri primer kot stran HTML v brskalniku in si oglej izpis v konzoli brskalnika. Po prvih treh vrsticah v polje vtipkaj `a@b.co` in pritisni Tab. Za oznako koraka sledijo stolpci `valid`, `valueMissing`, `typeMismatch` in `tooShort`. Isti naslov s šestimi kodnimi enotami ima v obeh primerih veljavno skladnjo, vendar `minLength = 8` krši šele po ročnem vnosu.

Povezane lekcije

  • JavaScript · Lekcija 22 · Srednja · Različica: 3

Viri