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

CKTIS / HTML

form — HTML formulář

Prvek form přiřazuje ovládací prvky k formuláři a určuje, jak se jejich data odesílají. Podporuje nativní odesílání a validaci; JavaScript může odesílání zachytit.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<form action="/search" method="get">…</form>

form představuje formulář, jehož ovládací prvky mohou poskytovat data ke zpracování. Je nutná otevírací i uzavírací značka; formuláře se nesmějí vnořovat. Podporované ovládací prvky mimo formulář k němu lze přiřadit pomocí atributu form, který odkazuje na jeho id.

action určuje cíl. method="get" (výchozí hodnota) umístí data do dotazu URL, zatímco method="post" je umístí do těla požadavku. Při odesílání souborů metodou POST použijte enctype="multipart/form-data". Samotná metoda POST neposkytuje šifrování.

Klíče dat pocházejí z name, nikoli z id. Zakázané ovládací prvky a nezaškrtnutá políčka se vynechávají. Ovládací prvky bez názvu se obvykle vynechávají, ale pokud se formulář odešle obrázkovým tlačítkem (<input type="image">) bez názvu, tlačítko přidá do dat souřadnice s klíči x a y. Přiřaďte popisky k polím. Validace v prohlížeči uživatelům pomáhá, ale nenahrazuje validaci na serveru.

Při běžném odeslání proběhne interaktivní validace před vyvoláním události submit, pokud se validace nepřeskočí. Pokud validace selže, odesílání se zastaví a událost submit se nevyvolá. Atribut novalidate umožňuje přeskočit interaktivní validaci. Ve skriptech upřednostněte requestSubmit(): na rozdíl od submit() zachovává validaci i událost submit.

Pří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ýsledek

q=html

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