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

CKTIS / HTML

form — formulário HTML

O elemento form associa controlos a um formulário e define como os respetivos dados são enviados. Suporta o envio e a validação nativos; o JavaScript pode intercetar o envio.

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

Sintaxe

<form action="/search" method="get">…</form>

form representa um formulário cujos controlos podem fornecer dados para processamento. São necessárias as etiquetas de abertura e de fecho; os formulários não devem ser aninhados. Os controlos suportados que estejam fora do formulário podem ser associados através de um atributo form que referencia o respetivo id.

action indica o destino. method="get" (o valor predefinido) coloca os dados na consulta do URL, enquanto method="post" os coloca no corpo do pedido. Para carregar ficheiros com POST, utilize enctype="multipart/form-data". POST, por si só, não fornece encriptação.

As chaves dos dados provêm de name, não de id. São omitidos os controlos desativados e as caixas de verificação que não estejam selecionadas. Os controlos sem nome são geralmente omitidos, mas, se for utilizado um botão de envio do tipo imagem (<input type="image">) sem nome para enviar o formulário, este acrescenta aos dados as coordenadas com as chaves x e y. Associe os rótulos aos campos. A validação do navegador ajuda os utilizadores, mas não substitui a validação no servidor.

Num envio normal, a validação interativa ocorre antes de ser desencadeado o evento submit, a menos que seja ignorada. Se a validação falhar, o envio é interrompido e o evento submit não é desencadeado. O atributo novalidate permite ignorar a validação interativa. Nos scripts, prefira requestSubmit(): ao contrário de submit(), mantém a validação e o evento submit.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML form example</title>
</head>
<body>
  <form id="search" method="get">
    <label for="query">Query</label>
    <input id="query" name="q" value="html" required>
    <button id="submit-query" type="submit">Submit query</button>
  </form>
  <output id="result" for="query" aria-live="polite"></output>
  <script>
    const form = document.getElementById('search');
    const submitButton = document.getElementById('submit-query');
    const result = document.getElementById('result');

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      const data = new FormData(form);
      result.value = 'q=' + data.get('q');
      console.log(result.value);
    });

    form.requestSubmit(submitButton);
  </script>
</body>
</html>

Resultado

q=html

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