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

CKTIS / HTML

select — controlo de seleção

O elemento `select` permite escolher entre as opções de um formulário. Aprende sobre a seleção única e múltipla, as etiquetas e o papel de `name` ao submeter dados.

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

Sintaxe

<select name="field" id="field"><option value="value">Label</option></select>

select oferece uma escolha entre elementos option. Sem multiple, permite uma seleção única; com multiple, permite selecionar zero ou mais opções. size indica o número de entradas visíveis.

Associa um label ao controlo fazendo corresponder os valores de for e id. name é a chave nos dados do formulário, enquanto id identifica o controlo e não é a respetiva chave de submissão. Cada opção selecionada e ativa contribui com o seu valor; com multiple, a chave pode repetir-se. Um controlo com disabled é omitido.

Numa seleção única obrigatória com um tamanho de apresentação igual a 1, a primeira opção tem de servir de marcador de posição: tem de ter um valor vazio e ser filha direta de select, não de um optgroup nem de qualquer outro elemento. Selecionar apenas essa opção não satisfaz required.

No exemplo, a opção dark está selecionada inicialmente. O script lê os dados do formulário sem os enviar para um servidor. O resultado representa o estado inicial e não é atualizado quando a seleção muda.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Select example</title>
<form id="settings">
  <label for="theme">Theme</label>
  <select id="theme" name="theme" required>
    <option value="">Choose a theme</option>
    <option value="light">Light</option>
    <option value="dark" selected>Dark</option>
  </select>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('settings');
  const data = new FormData(form);
  document.getElementById('result').textContent = data.get('theme');
</script>
</html>

Resultado

dark

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