CKTIS / HTML
formtarget — miejsce wyświetlenia wyniku wysłania formularza
Atrybut formtarget wskazuje, gdzie ma zostać załadowany wynik wysłania formularza przez dany przycisk. Nadpisuje target formularza dla tego wysłania, umożliwiając użycie bieżącej karty, nowego okna lub karty albo nazwanej ramki.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
formtarget="_self|_blank|_parent|_top|target-name"formtarget określa docelowy kontekst nawigacji podczas wysyłania formularza. Stosuje się go na przyciskach wysyłających: button typu submit oraz input typu submit lub image. Nie jest atrybutem elementu form ani zwykłego pola tekstowego.
Wartość z przycisku użytego do wysłania ma pierwszeństwo przed target powiązanego formularza. Pominięcie formtarget pozostawia wybór celu formularzowi. Atrybut nie zmienia adresu żądania, metody ani danych; adres nadpisuje formaction, a metodę — formmethod.
Wartością jest prawidłowa nazwa celu lub słowo kluczowe. _self oznacza bieżący kontekst, _blank — nowy kontekst najwyższego poziomu, zwykle kartę lub okno, _parent — kontekst nadrzędny, a _top — najwyższy. Bez rodzica _parent i _top działają jak _self. Nazwa taka jak preview może wskazywać iframe z pasującym name; samo id nie wystarcza. To atrybut tekstowy, nie logiczny.
Otwórz plik demo.html przez lokalny serwer HTTP; kod po stronie serwera nie jest potrzebny. Skrypt automatycznie wywołuje requestSubmit() dla każdego przycisku. Dla Standard celem jest _self z formularza (bieżąca strona), a dla Preview ustawienie formtarget="preview" ma pierwszeństwo przed target="_self" i wskazuje nazwaną ramkę iframe. Procedura obsługi zdarzenia submit wywołuje preventDefault(), więc żaden z przycisków nie powoduje wysłania formularza ani nawigacji. Konsola pokazuje wybrane cele, a nie załadowany wynik.
Przykłady
<!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>Wynik
Standard: _self (current page) Preview: preview (named iframe)
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.