Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ValidityState: ukupna valjanost i uzroci pogrešaka

S pomoću `element.validity` razlikuj valjano polje od polja bez obvezne vrijednosti, s neispravnim formatom ili s prekratkom vrijednošću koju je unio korisnik.

Verzija: 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 vraća objekt ValidityState za kontrolu obrasca. Njegova logička svojstva služe samo za čitanje i odražavaju trenutačno stanje: spremljena referenca nije snimka stanja. To je API web-platforme, a ne dio ECMAScripta.

valid je true samo ako nije postavljena nijedna zastavica pogreške, uključujući one koje ovdje nisu opisane, kao što je customError. Više zastavica može istodobno biti true. valueMissing je true kad nedostaje vrijednost koju zahtijeva required, primjerice u praznom obveznom polju za e-poštu.

typeMismatch je true ako neprazna vrijednost ne zadovoljava pravila HTML sintakse za type="email" ili type="url". Za e-poštu multiple dopušta popis adresa odvojenih zarezima. Prazno obvezno polje za e-poštu ima valueMissing, a ne typeMismatch. Provjera sintakse ne potvrđuje da adresa postoji.

tooShort je true kad se minlength primjenjuje na input ili textarea, zastavica promjene vrijednosti (dirty value flag) je postavljena, posljednju promjenu vrijednosti napravio je korisnik, a neprazna vrijednost koju izlaže API ima manje kodnih jedinica UTF-16 od minimuma. Sam minlength ne čini polje obveznim. Dodjela vrijednosti svojstvu .value ne izaziva tu pogrešku, čak ni ako potom pozoveš checkValidity() ili reportValidity().

S pomoću valid provjeri ukupno stanje polja, a prema zastavicama pogrešaka odaberi poruku. Poslane podatke ponovno provjeri na poslužitelju: provjeru u pregledniku moguće je zaobići.

Primjeri

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

Otvori primjer kao HTML stranicu u pregledniku i pogledaj ispis u konzoli preglednika. Nakon prva tri retka u polje upiši `a@b.co` i pritisni Tab. Nakon oznake koraka slijede `valid`, `valueMissing`, `typeMismatch` i `tooShort`. Ista adresa od šest kodnih jedinica sintaktički je valjana u oba slučaja, ali krši `minLength = 8` tek nakon ručnog unosa.

Povezane lekcije

  • JavaScript · Lekcija 22 · Srednje · Verzija: 3

Izvori