CKTIS / HTML
formtarget — kje se prikaže rezultat pošiljanja obrazca
Atribut formtarget določa, kam se naloži rezultat pošiljanja obrazca, ki ga sproži določen gumb. Pri tem pošiljanju preglasi target obrazca in omogoča uporabo trenutnega zavihka, novega okna ali zavihka oziroma poimenovanega okvira.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
formtarget="_self|_blank|_parent|_top|target-name"formtarget določa cilj navigacije pri pošiljanju obrazca. Uporablja se pri gumbih za pošiljanje: button z vrsto submit ter input z vrsto submit ali image. Ni atribut elementa form ali običajnega besedilnega polja.
Vrednost gumba, uporabljenega za pošiljanje, ima prednost pred atributom target povezanega obrazca. Če formtarget ni naveden, cilj določi obrazec. Atribut ne spremeni URL-ja zahteve, metode ali podatkov; formaction preglasi URL, formmethod pa metodo.
Vrednost je veljavno ime cilja ali ključna beseda. _self pomeni trenutni kontekst, _blank nov kontekst najvišje ravni, običajno zavihek ali okno, _parent nadrejeni kontekst, _top pa najvišji kontekst. Če nadrejenega konteksta ni, se _parent in _top obnašata kot _self. Ime, kot je preview, lahko izbere iframe z ustreznim name; samo id ne zadostuje. To je atribut z besedilno vrednostjo, ne logični atribut.
Odprite demo.html prek lokalnega strežnika HTTP; strežniška koda ni potrebna. Skript za vsak gumb samodejno pokliče requestSubmit(). Standard uporabi cilj _self iz obrazca (trenutno stran), pri gumbu Preview pa formtarget="preview" preglasi target="_self" in izbere poimenovani iframe. Obdelovalnik dogodka submit pokliče preventDefault(), zato nobeden od gumbov ne pošlje obrazca ali sproži navigacije. Konzola izpiše izbrane cilje, ne naloženega rezultata.
Primeri
<!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>Rezultat
Standard: _self (current page) Preview: preview (named iframe)
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.