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.