KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

formtarget — waar het resultaat van een formulierverzending wordt weergegeven

Het attribuut formtarget bepaalt waar het resultaat wordt geladen van een formulierverzending die door een bepaalde knop is gestart. Voor die verzending overschrijft het het target van het formulier, zodat het huidige tabblad, een nieuw venster of tabblad, of een benoemd frame kan worden gebruikt.

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

Syntax

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

formtarget geeft de navigatiebestemming voor een formulierverzending op. Het geldt voor verzendknoppen: button met type submit en input met type submit of image. Het is geen attribuut van het element form of van een gewoon tekstveld.

De waarde op de knop waarmee het formulier wordt verzonden, heeft voorrang op het target van het bijbehorende formulier. Als formtarget ontbreekt, bepaalt het formulier de bestemming. Het attribuut verandert de URL van het verzoek, de methode en de gegevens niet; formaction overschrijft de URL en formmethod de methode.

De waarde is een geldige doelnaam of een sleutelwoord. _self betekent de huidige context, _blank een nieuwe context op het hoogste niveau, meestal een tabblad of venster, _parent de bovenliggende context en _top de bovenste context. Zonder bovenliggende context werken _parent en _top als _self. Een naam zoals preview kan een iframe met een overeenkomende name selecteren; alleen een id is niet voldoende. Dit is een attribuut met een tekenreekswaarde, geen booleaans attribuut.

Open demo.html via een lokale HTTP-server; servercode is niet nodig. Het script roept voor elke knop automatisch requestSubmit() aan. Standard gebruikt de formulierbestemming _self (de huidige pagina). Bij Preview heeft formtarget="preview" voorrang op target="_self" en wordt het iframe met die naam geselecteerd. De handler voor de submit-gebeurtenis roept preventDefault() aan, zodat geen van beide knoppen het formulier verzendt of navigatie veroorzaakt. De console toont de geselecteerde bestemmingen, niet een geladen resultaat.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen