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

CKTIS / HTML

formmethod — metoda odeslání pro tlačítko

Atribut formmethod vybírá metodu odeslání formuláře pro konkrétní odesílací tlačítko. Přijímá get, post a dialog a při odeslání vyvolaném tímto tlačítkem přepisuje method formuláře.

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

Syntaxe

formmethod="get|post|dialog"

formmethod se používá u odesílacích tlačítek: u prvků button, které tuto funkci plní, a u prvků input s type="submit" nebo type="image". Prvek button může fungovat jako odesílací tlačítko i bez atributu type; type="submit" tedy není nutné uvádět výslovně. Atribut formmethod ovlivňuje odeslání vyvolané daným tlačítkem, aniž by měnil atribut method formuláře.

get odesílá data v URL, zatímco post je odesílá v těle požadavku HTTP. dialog místo odeslání dat zavře předka formuláře, kterým je element dialog; pokud takový předek neexistuje, k odeslání nedojde.

Pokud formmethod chybí, použije se method přidruženého formuláře. Neplatná hodnota, včetně prázdného řetězce, místo toho vybere get, nikoli metodu formuláře. Pokud samotný formulář nemá method, výchozí metodou je get.

V příkladu formmethod="dialog" přepisuje method="post". Kliknutí na Close zavře dialog bez požadavku formuláře a nastaví jeho returnValue na done, tedy hodnotu tlačítka.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>formmethod</title>
<dialog id="demo">
  <form method="post">
    <button type="submit" formmethod="dialog" value="done">Close</button>
  </form>
</dialog>
<output id="result">waiting</output>
<script>
  const demo = document.getElementById('demo');
  const result = document.getElementById('result');
  demo.addEventListener('close', () => {
    result.textContent = demo.returnValue;
  });
  demo.showModal();
</script>

Výsledek

done

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