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

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.

Fontes