Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

formtarget — où le résultat de l’envoi d’un formulaire s’affiche

L’attribut formtarget indique où charger le résultat d’un envoi de formulaire déclenché par un bouton donné. Il remplace le target du formulaire pour cet envoi et permet d’utiliser l’onglet actuel, une nouvelle fenêtre ou un nouvel onglet, ou un cadre nommé.

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

Syntaxe

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

formtarget indique la destination de navigation d’un envoi de formulaire. Il s’applique aux boutons d’envoi : button de type submit et input de type submit ou image. Ce n’est ni un attribut de l’élément form ni celui d’un champ de texte ordinaire.

La valeur du bouton utilisé pour envoyer le formulaire prime sur le target du formulaire associé. Si formtarget est omis, le formulaire détermine la destination. L’attribut ne modifie ni l’URL de la requête, ni la méthode, ni les données ; formaction remplace l’URL et formmethod la méthode.

La valeur est un nom de destination valide ou un mot-clé. _self désigne le contexte actuel, _blank un nouveau contexte de premier niveau, généralement un onglet ou une fenêtre, _parent le contexte parent et _top le contexte le plus élevé. En l’absence de parent, _parent et _top se comportent comme _self. Un nom tel que preview peut désigner un iframe ayant un name correspondant ; un id seul ne suffit pas. Cet attribut contient une chaîne de caractères, ce n’est pas un attribut booléen.

Ouvrez demo.html via un serveur HTTP local ; aucun code côté serveur n’est nécessaire. Le script appelle automatiquement requestSubmit() pour chaque bouton. Standard utilise la destination _self du formulaire (la page actuelle), tandis que Preview définit formtarget="preview", qui prend le pas sur target="_self" et désigne l’iframe nommé. Le gestionnaire de l’événement submit appelle preventDefault() : aucun des deux boutons n’envoie le formulaire ni ne déclenche de navigation. La console indique les destinations sélectionnées, et non un résultat chargé.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources