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

CKTIS / HTML

formaction — URL pro odeslání tlačítkem

Atribut formaction přepíše action formuláře, když odeslání spustí konkrétní tlačítko. Umožňuje odesílat stejný formulář na různé URL, aniž by se změnil jeho výchozí cíl.

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

Syntaxe

<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">

formaction určuje URL pro odeslání konkrétním odesílacím tlačítkem: odesílajícím prvkem button nebo prvkem input s type="submit" či type="image". Nesmí být použit u běžného tlačítka ani u tlačítka pro resetování.

Pokud má tlačítko, které formulář odesílá, atribut formaction, jeho hodnota při tomto odeslání přepíše action souvisejícího formuláře. Bez tohoto atributu se použije action formuláře. Hodnota musí být platná, neprázdná URL; relativní URL je povolena.

Atribut mění cíl, nikoli metodu HTTP, kódování ani pravidla ověřování. V příkladu formulář nemá atribut method, takže výchozí metodou je GET. Obsluha události submit zruší odeslání a do konzole vypíše pouze text tlačítka a fragment vybrané URL: #publish pro Publish a #preview pro Preview. Příklad neodesílá žádný požadavek GET.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Button-specific form action</title>
</head>
<body>
  <h1>Choose a form action</h1>
  <form id="editor" action="#publish">
    <button type="submit">Publish</button>
    <button type="submit" formaction="#preview">Preview</button>
  </form>
  <p id="publish">Local publish destination.</p>
  <p id="preview">Local preview destination.</p>
  <script>
    const form = document.getElementById('editor');
    form.addEventListener('submit', event => {
      event.preventDefault();
      const button = event.submitter;
      const action = button.hasAttribute('formaction') ? button.formAction : form.action;
      console.log(`${button.textContent}: ${new URL(action).hash}`);
    });
    for (const button of form.querySelectorAll('button')) {
      form.requestSubmit(button);
    }
  </script>
</body>
</html>

Výsledek

Publish: #publish
Preview: #preview

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