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.