Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

formaction — URL na odoslanie tlačidlom

Atribút formaction prepíše action formulára, keď odoslanie spustí konkrétne tlačidlo. Umožňuje odosielať ten istý formulár na rôzne URL bez zmeny jeho predvoleného cieľa.

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

Syntax

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

formaction určuje URL na odoslanie konkrétnym odosielacím tlačidlom: odosielacím prvkom button alebo prvkom input s type="submit" či type="image". Nesmie sa použiť na bežnom tlačidle ani na tlačidle na resetovanie.

Ak má tlačidlo, ktoré odosiela formulár, atribút formaction, jeho hodnota pri tomto odoslaní prepíše action súvisiaceho formulára. Bez tohto atribútu sa použije action formulára. Hodnota musí byť platná, neprázdna URL; relatívna URL je povolená.

Atribút mení cieľ, nie metódu HTTP, kódovanie ani pravidlá overovania. V príklade formulár nemá atribút method, takže predvolenou metódou je GET. Obsluha udalosti submit zruší odoslanie a do konzoly vypíše iba text tlačidla a fragment vybranej URL: #publish pre Publish a #preview pre Preview. Príklad neodosiela žiadnu požiadavku GET.

Prí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ýsledok

Publish: #publish
Preview: #preview

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje