Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Formuláře a kontrola platnosti

Pomocí události `input` reaguj na změny v poli a pomocí `submit` zpracuj odeslání formuláře po úspěšné standardní validaci. Rozhraní `HTMLFormElement` nabízí také metody pro explicitní kontrolu platnosti formuláře.

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

Syntaxe

field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();

HTMLFormElement je rozhraní DOM prohlížeče, které reprezentuje prvek form. Vlastnost form.elements umožňuje přístup k ovládacím prvkům přidruženým k formuláři. Jde o webové API, nikoli o součást jazyka ECMAScript.

Pomocí události input můžeš reagovat na změny provedené uživatelem a třeba při psaní aktualizovat nápovědu. Samotné přiřazení hodnoty do field.value v JavaScriptu událost input nevyvolá. Atribut required způsobí, že prázdné textové pole není platné. form.checkValidity() vrací výsledek jako logickou hodnotu. form.reportValidity() také vrací logickou hodnotu a navíc uživateli zobrazuje chyby validace, pokud není zrušena událost invalid příslušného ovládacího prvku. Zrušení této události nemění výsledek validace: metoda vrátí false, aniž zobrazí chybu pro tento prvek.

Při běžném pokusu o odeslání prohlížeč nejprve zkontroluje omezení. Pokud je některé pole neplatné, prohlížeč odeslání zablokuje a událost submit se nevyvolá. Pokud validace proběhne úspěšně, událost submit se vyvolá na formuláři, nikoli na tlačítku. Voláním event.preventDefault() v obsluze této události zrušíš výchozí odeslání.

Stejný postup můžeš spustit z kódu pomocí form.requestSubmit(). Přímé volání form.submit() obchází validaci i událost submit. Validace v prohlížeči pomáhá uživatelům opravit zadané údaje, ale nenahrazuje validaci na serveru.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
  <label>Name <input name="displayName" required></label>
  <button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.querySelector('#profile');
  const field = form.elements.namedItem('displayName');
  const log = document.querySelector('#log');
  const append = (line) => { log.textContent += line + '\n'; };

  field.addEventListener('input', () => {
    append(`input: ${form.checkValidity()}`);
  });
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    append(`submit: ${field.value}`);
  });

  append(`initial: ${form.checkValidity()}`);
</script>

Výsledek

initial: false
input: true
submit: A

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje