Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

formtarget — onde é apresentado o resultado do envio de um formulário

O atributo formtarget indica onde carregar o resultado do envio de um formulário iniciado por um botão específico. Nesse envio, substitui o target do formulário e permite utilizar o separador atual, uma nova janela ou separador, ou uma frame com nome.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

formtarget especifica o contexto de navegação de destino para o envio de um formulário. Aplica-se aos botões de envio: button com o tipo submit e input com o tipo submit ou image. Não é um atributo do elemento form nem de um campo de texto normal.

O valor do botão utilizado para enviar o formulário tem prioridade sobre o target do formulário associado. Se formtarget for omitido, o formulário determina o destino. O atributo não altera o URL do pedido, o método nem os dados; formaction substitui o URL e formmethod o método.

O valor é um nome de destino válido ou uma palavra-chave. _self significa o contexto atual, _blank um novo contexto de nível superior, geralmente um separador ou janela, _parent o contexto ascendente e _top o contexto mais elevado. Sem um contexto ascendente, _parent e _top funcionam como _self. Um nome como preview pode selecionar um iframe com um name correspondente; um id por si só não é suficiente. É um atributo com valor de cadeia de caracteres, não um atributo booleano.

Abra demo.html através de um servidor HTTP local; não é necessário código do lado do servidor. O script chama automaticamente requestSubmit() para cada botão. Standard utiliza o destino _self do formulário (a página atual), enquanto Preview define formtarget="preview", que tem prioridade sobre target="_self" e seleciona o iframe com esse nome. O processador do evento submit chama preventDefault(), pelo que nenhum dos botões envia o formulário nem desencadeia uma navegação. A consola apresenta os destinos selecionados, não um resultado carregado.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes