CKTIS / HTML
formtarget — kde sa zobrazí výsledok odoslania formulára
Atribút formtarget určuje, kam sa načíta výsledok odoslania formulára vyvolaného konkrétnym tlačidlom. Pri tomto odoslaní nahrádza target formulára a umožňuje použiť aktuálnu kartu, nové okno alebo kartu, prípadne pomenovaný rám.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
formtarget="_self|_blank|_parent|_top|target-name"formtarget určuje cieľ navigácie pri odoslaní formulára. Používa sa pri odosielacích tlačidlách: button typu submit a input typu submit alebo image. Nie je to atribút prvku form ani bežného textového poľa.
Hodnota tlačidla použitého na odoslanie má prednosť pred atribútom target príslušného formulára. Ak formtarget chýba, cieľ určuje formulár. Atribút nemení URL požiadavky, metódu ani údaje; formaction nahrádza URL a formmethod metódu.
Hodnota je platný názov cieľa alebo kľúčové slovo. _self označuje aktuálny kontext, _blank nový kontext najvyššej úrovne, zvyčajne kartu alebo okno, _parent nadradený kontext a _top najvyšší kontext. Ak nadradený kontext neexistuje, _parent a _top fungujú ako _self. Názov ako preview môže vybrať iframe so zodpovedajúcim name; samotné id nestačí. Ide o atribút s reťazcovou hodnotou, nie o booleovský atribút.
Otvorte demo.html cez miestny HTTP server; kód na strane servera nie je potrebný. Skript pre každé tlačidlo automaticky zavolá requestSubmit(). Standard používa cieľ _self z formulára (aktuálnu stránku), zatiaľ čo pri tlačidle Preview má formtarget="preview" prednosť pred target="_self" a určuje pomenovaný iframe. Obsluha udalosti submit volá preventDefault(), takže ani jedno tlačidlo neodošle formulár ani nespustí navigáciu. Konzola vypisuje vybraté ciele, nie načítaný výsledok.
Prí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ýsledok
Standard: _self (current page) Preview: preview (named iframe)
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.