CKTIS / HTML
formaction — URL de submissão de um botão
O atributo formaction substitui action de um formulário quando um botão específico inicia a submissão. Permite enviar o mesmo formulário para URLs diferentes sem alterar o destino predefinido do formulário.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">formaction especifica o URL de submissão para um botão de submissão específico: um button que submete o formulário ou um input com type="submit" ou type="image". Não deve ser colocado num botão normal nem num botão de reposição.
Se o botão que submete o formulário tiver formaction, o respetivo valor substitui action do formulário associado apenas nessa submissão. Sem este atributo, aplica-se action do formulário. O valor tem de ser um URL válido e não vazio; é permitido um URL relativo.
O atributo altera o destino, não o método HTTP, a codificação nem as regras de validação. No exemplo, o formulário não tem o atributo method, pelo que GET é o método predefinido. O processador do evento submit cancela a submissão e regista na consola apenas o texto do botão e o fragmento do URL selecionado: #publish para Publish e #preview para Preview. O exemplo não envia nenhum pedido GET.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Button-specific form action</title>
</head>
<body>
<h1>Choose a form action</h1>
<form id="editor" action="#publish">
<button type="submit">Publish</button>
<button type="submit" formaction="#preview">Preview</button>
</form>
<p id="publish">Local publish destination.</p>
<p id="preview">Local preview destination.</p>
<script>
const form = document.getElementById('editor');
form.addEventListener('submit', event => {
event.preventDefault();
const button = event.submitter;
const action = button.hasAttribute('formaction') ? button.formAction : form.action;
console.log(`${button.textContent}: ${new URL(action).hash}`);
});
for (const button of form.querySelectorAll('button')) {
form.requestSubmit(button);
}
</script>
</body>
</html>Resultado
Publish: #publish Preview: #preview
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.