WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

formtarget — wo das Ergebnis einer Formularübermittlung angezeigt wird

Das Attribut formtarget legt fest, wo das Ergebnis einer durch eine bestimmte Schaltfläche ausgelösten Formularübermittlung geladen wird. Für diese Übermittlung überschreibt es das target des Formulars und ermöglicht die aktuelle Registerkarte, ein neues Fenster oder eine neue Registerkarte oder einen benannten Frame.

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

Syntax

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

formtarget gibt das Navigationsziel für eine Formularübermittlung an. Es gilt für Submit-Schaltflächen: button mit dem Typ submit sowie input mit dem Typ submit oder image. Es ist kein Attribut des Elements form und auch kein Attribut eines gewöhnlichen Textfelds.

Der Wert der zum Absenden verwendeten Schaltfläche hat Vorrang vor target des zugehörigen Formulars. Fehlt formtarget, bestimmt das Formular das Ziel. Das Attribut ändert weder die URL der Anfrage noch die Methode oder die Daten; formaction überschreibt die URL und formmethod die Methode.

Der Wert ist ein gültiger Zielname oder ein Schlüsselwort. _self bezeichnet den aktuellen Kontext, _blank einen neuen Kontext der obersten Ebene, gewöhnlich eine Registerkarte oder ein Fenster, _parent den übergeordneten Kontext und _top den obersten Kontext. Gibt es keinen übergeordneten Kontext, verhalten sich _parent und _top wie _self. Ein Name wie preview kann ein iframe mit einem passenden name auswählen; eine id allein reicht nicht aus. Dieses Attribut enthält eine Zeichenfolge und ist kein boolesches Attribut.

Rufe demo.html über einen lokalen HTTP-Server auf; serverseitiger Code ist nicht erforderlich. Das Skript ruft für jede Schaltfläche automatisch requestSubmit() auf. Standard verwendet das Formularziel _self (die aktuelle Seite). Bei Preview überschreibt formtarget="preview" das Formularziel target="_self" und wählt den benannten iframe aus. Der Handler für das Ereignis submit ruft preventDefault() auf. Daher sendet keine der beiden Schaltflächen das Formular ab oder löst eine Navigation aus. Die Konsole gibt die ausgewählten Ziele aus, kein geladenes Ergebnis.

Beispiele

<!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>

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen