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

CKTIS / HTML

formmethod — método de envio de um botão

O atributo formmethod seleciona o método de envio do formulário para um botão de envio específico. Aceita get, post e dialog e substitui method do formulário quando o envio é iniciado por esse botão.

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

Sintaxe

formmethod="get|post|dialog"

formmethod aplica-se aos botões de envio: aos elementos button que desempenham essa função e aos elementos input com type="submit" ou type="image". Um elemento button pode funcionar como botão de envio mesmo quando se omite o atributo type; não é necessário indicar explicitamente type="submit". O atributo formmethod afeta o envio iniciado por esse botão sem alterar o atributo method do formulário.

get envia os dados no URL, enquanto post os envia no corpo do pedido HTTP. dialog fecha o elemento dialog ancestral do formulário em vez de enviar os dados; sem um ancestral desse tipo, não ocorre qualquer envio.

Se formmethod for omitido, é usado method do formulário associado. Um valor inválido, incluindo uma cadeia vazia, seleciona antes get, e não o método do formulário. Se o próprio formulário não tiver method, o valor predefinido é get.

No exemplo, formmethod="dialog" substitui method="post". Ao clicar em Close, a caixa de diálogo fecha sem enviar um pedido do formulário e o seu returnValue passa a done, o valor do botão.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>formmethod</title>
<dialog id="demo">
  <form method="post">
    <button type="submit" formmethod="dialog" value="done">Close</button>
  </form>
</dialog>
<output id="result">waiting</output>
<script>
  const demo = document.getElementById('demo');
  const result = document.getElementById('result');
  demo.addEventListener('close', () => {
    result.textContent = demo.returnValue;
  });
  demo.showModal();
</script>

Resultado

done

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