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

CKTIS / HTML

method — método de submissão do formulário

O atributo method do elemento form seleciona get, post ou dialog. Determina como os dados do formulário são submetidos ou fecha uma caixa de diálogo em vez de fazer um pedido de rede.

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

Sintaxe

<form method="get|post|dialog">…</form>

O atributo method do elemento form seleciona a forma como a submissão do formulário é processada. Os valores permitidos são get, post e dialog. Se o atributo for omitido ou tiver um valor inválido, incluindo uma cadeia vazia ou put, é selecionado o estado GET.

Para destinos HTTP(S), get coloca os dados codificados do formulário na consulta do URL, enquanto post os envia no corpo do pedido. O atributo action especifica o destino; enctype especifica a codificação do corpo para post.

O valor dialog fecha o elemento dialog ancestral mais próximo sem enviar dados pela rede. Se não existir um ancestral desse tipo, a submissão não prossegue. A validação ainda pode impedir esta operação. No exemplo, o botão define returnValue da caixa de diálogo como ok.

Um atributo formmethod no botão de submissão utilizado substitui o method do formulário. Se estiver ausente, aplica-se a definição do formulário; um formmethod inválido seleciona GET em vez de herdar a definição.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>method demo</title>
<dialog id="choice">
  <form method="dialog">
    <button type="submit" value="ok">OK</button>
  </form>
</dialog>
<pre id="result">waiting</pre>
<script>
  const choice = document.getElementById('choice');
  const result = document.getElementById('result');
  choice.addEventListener('close', () => {
    result.textContent = `returnValue=${choice.returnValue}`;
  });
  choice.showModal();
</script>
</html>

Resultado

returnValue=ok

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