CKTIS / HTML
form — HTML formulár
Prvok form priraďuje ovládacie prvky k formuláru a určuje, ako sa ich údaje odosielajú. Podporuje natívne odosielanie a validáciu; JavaScript môže odosielanie zachytiť.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<form action="/search" method="get">…</form>form predstavuje formulár, ktorého ovládacie prvky môžu poskytovať údaje na spracovanie. Potrebná je otváracia aj zatváracia značka; formuláre sa nesmú vnárať. Podporované ovládacie prvky mimo formulára sa k nemu dajú priradiť pomocou atribútu form, ktorý odkazuje na jeho id.
action určuje cieľ. method="get" (predvolená hodnota) umiestni údaje do dopytu URL, zatiaľ čo method="post" ich umiestni do tela požiadavky. Pri odosielaní súborov metódou POST použite enctype="multipart/form-data". Samotná metóda POST neposkytuje šifrovanie.
Kľúče údajov pochádzajú z name, nie z id. Zakázané ovládacie prvky a nezačiarknuté políčka sa vynechávajú. Ovládacie prvky bez názvu sa zvyčajne vynechávajú, ale ak sa formulár odošle obrázkovým tlačidlom (<input type="image">) bez názvu, tlačidlo pridá do údajov súradnice s kľúčmi x a y. Priraďte popisy k poliam. Validácia v prehliadači pomáha používateľom, ale nenahrádza validáciu na serveri.
Pri bežnom odoslaní prebehne interaktívna validácia pred vyvolaním udalosti submit, pokiaľ sa validácia nepreskočí. Ak validácia zlyhá, odosielanie sa zastaví a udalosť submit sa nevyvolá. Atribút novalidate umožňuje preskočiť interaktívnu validáciu. V skriptoch uprednostnite requestSubmit(): na rozdiel od submit() zachováva validáciu aj udalosť submit.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML form example</title>
</head>
<body>
<form id="search" method="get">
<label for="query">Query</label>
<input id="query" name="q" value="html" required>
<button id="submit-query" type="submit">Submit query</button>
</form>
<output id="result" for="query" aria-live="polite"></output>
<script>
const form = document.getElementById('search');
const submitButton = document.getElementById('submit-query');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const data = new FormData(form);
result.value = 'q=' + data.get('q');
console.log(result.value);
});
form.requestSubmit(submitButton);
</script>
</body>
</html>Výsledok
q=html
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.