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

CKTIS / HTML

input — controlo de formulário

O elemento `input` representa um campo de dados ou um botão, consoante `type`. Aprende a escolher o tipo, fornecer uma etiqueta e um nome para o envio e aplicar restrições básicas aos valores.

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

Sintaxe

<input type="text" id="username" name="username" value="Ada" required>

input representa um campo de dados tipado, normalmente com um controlo que permite editá-lo. type seleciona o comportamento, por exemplo text, email, number, checkbox ou submit. Se type estiver em falta ou tiver um valor inválido, aplica-se text. O elemento não tem conteúdo nem etiqueta de fecho.

Fornece uma etiqueta visível com label: o respetivo for referencia o id do controlo. Um placeholder não substitui uma etiqueta. name determina o nome dos dados no envio do formulário; id, por si só, não o fornece. Para texto com várias linhas, utiliza textarea.

Os atributos aplicáveis dependem do tipo. required exige um valor ou um estado selecionado adequado; min, max e step restringem os valores suportados. disabled desativa o controlo e exclui-o do envio. Quando aplicável, readonly impede a edição, mas não exclui o valor do envio. A validação no cliente não substitui as verificações no servidor.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Input example</title>
<form>
  <label for="username">Username</label>
  <input type="text" id="username" name="username" value="Ada" required>
</form>
<pre id="result"></pre>
<script>
  const field = document.getElementById('username');
  document.getElementById('result').textContent =
    field.value + '\n' + field.checkValidity();
</script>
</html>

Resultado

Ada
true

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