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.