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.