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

CKTIS / HTML

formtarget — kde se zobrazí výsledek odeslání formuláře

Atribut formtarget určuje, kam se načte výsledek odeslání formuláře vyvolaného konkrétním tlačítkem. Pro toto odeslání přepíše target formuláře a umožňuje použít aktuální kartu, nové okno či kartu nebo pojmenovaný rám.

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

Syntaxe

formtarget="_self|_blank|_parent|_top|target-name"

formtarget určuje cíl navigace při odeslání formuláře. Používá se u odesílacích tlačítek: button typu submit a input typu submit nebo image. Není to atribut prvku form ani běžného textového pole.

Hodnota tlačítka použitého k odeslání má přednost před atributem target příslušného formuláře. Pokud formtarget chybí, cíl určuje formulář. Atribut nemění URL požadavku, metodu ani data; formaction přepisuje URL a formmethod metodu.

Hodnota je platný název cíle nebo klíčové slovo. _self označuje aktuální kontext, _blank nový kontext nejvyšší úrovně, obvykle kartu nebo okno, _parent nadřazený kontext a _top nejvyšší kontext. Pokud nadřazený kontext neexistuje, _parent a _top fungují jako _self. Název jako preview může vybrat iframe s odpovídajícím name; samotné id nestačí. Jde o atribut s řetězcovou hodnotou, nikoli o booleovský atribut.

Otevřete demo.html přes místní HTTP server; kód na straně serveru není potřeba. Skript pro každé tlačítko automaticky zavolá requestSubmit(). Standard používá cíl _self z formuláře (aktuální stránku), zatímco u tlačítka Preview má formtarget="preview" přednost před target="_self" a vybírá pojmenovaný iframe. Obsluha události submit volá preventDefault(), takže ani jedno tlačítko formulář neodešle ani nevyvolá navigaci. Konzole vypisuje vybrané cíle, nikoli načtený výsledek.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Button-specific form target</title>
</head>
<body>
  <h1>Choose a form target</h1>
  <form id="example" action="#result" target="_self">
    <button type="submit">Standard</button>
    <button type="submit" formtarget="preview">Preview</button>
  </form>
  <p id="result">Local destination for this example.</p>
  <iframe id="preview-frame" name="preview" title="Local preview" srcdoc="<p>Local preview frame.</p>"></iframe>
  <script>
    const form = document.getElementById('example');
    const frame = document.getElementById('preview-frame');
    form.addEventListener('submit', event => {
      event.preventDefault();
      const button = event.submitter;
      const target = button.hasAttribute('formtarget') ? button.formTarget : form.target;
      const destination = target === '_self' ? 'current page' :
        window.frames[target] === frame.contentWindow ? 'named iframe' : 'unmatched target';
      console.log(`${button.textContent}: ${target} (${destination})`);
    });
    for (const button of form.querySelectorAll('button')) {
      form.requestSubmit(button);
    }
  </script>
</body>
</html>

Výsledek

Standard: _self (current page)
Preview: preview (named iframe)

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