Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

formtarget — dove viene visualizzato il risultato dell’invio del modulo

L’attributo formtarget indica dove caricare il risultato dell’invio di un modulo avviato da un determinato pulsante. Per quell’invio sostituisce il target del modulo e consente di usare la scheda corrente, una nuova finestra o scheda oppure un frame con nome.

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

Sintassi

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

formtarget specifica il contesto di navigazione di destinazione per l’invio di un modulo. Si applica ai pulsanti di invio: button con tipo submit e input con tipo submit o image. Non è un attributo dell’elemento form né di un normale campo di testo.

Il valore del pulsante usato per inviare il modulo ha la precedenza sul target del modulo associato. Se formtarget è omesso, la scelta della destinazione spetta al modulo. L’attributo non cambia l’URL della richiesta, il metodo o i dati; formaction sostituisce l’URL e formmethod il metodo.

Il valore è un nome di destinazione valido o una parola chiave. _self indica il contesto corrente, _blank un nuovo contesto di primo livello, di solito una scheda o una finestra, _parent il contesto genitore e _top il contesto più alto. Se non esiste un genitore, _parent e _top si comportano come _self. Un nome come preview può selezionare un iframe con un name corrispondente; un id da solo non è sufficiente. È un attributo con valore stringa, non un attributo booleano.

Apri demo.html tramite un server HTTP locale; non serve codice lato server. Lo script chiama automaticamente requestSubmit() per ciascun pulsante. Standard usa la destinazione _self del modulo (la pagina corrente), mentre Preview imposta formtarget="preview", che ha la precedenza su target="_self" e seleziona l’iframe con quel nome. Il gestore dell’evento submit chiama preventDefault(), quindi nessuno dei due pulsanti invia il modulo o avvia una navigazione. La console riporta le destinazioni selezionate, non un risultato caricato.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti