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

CKTIS / HTML

multiple — vários valores num controlo de formulário

O atributo booleano `multiple` permite escolher várias opções em `select`, introduzir vários endereços num campo `email` ou selecionar vários ficheiros num campo `file`. O comportamento depende da presença do atributo, não do texto do seu valor.

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

Sintaxe

select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".

multiple é um atributo booleano: a sua presença ativa o comportamento e a sua ausência desativa-o. As formas válidas são multiple, multiple="" e multiple="multiple". Escrever multiple="false" é inválido e, ainda assim, ativa o comportamento, porque o atributo continua presente. Para o desativar, remove o atributo.

Em select, permite selecionar zero ou mais opções; sem ele, o controlo serve para selecionar uma única opção. Não seleciona automaticamente todas as opções. O atributo size determina quantas opções estão visíveis, não o limite de seleção.

Num campo email, permite uma lista de endereços separados por vírgulas, não por ponto e vírgula. Num campo file, permite selecionar vários ficheiros; sem ele, a lista de ficheiros selecionados pode conter, no máximo, um ficheiro. Não é um mecanismo geral para introduzir vários valores nos outros tipos de input.

O exemplo tem duas opções com o atributo selected. O script lê a propriedade multiple e os valores de selectedOptions e, em seguida, apresenta o resultado inicial. Não é necessário selecionar opções manualmente.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>multiple example</title>
<label for="topics">Topics</label>
<select id="topics" multiple>
  <option value="html" selected>HTML</option>
  <option value="css" selected>CSS</option>
</select>
<pre id="result"></pre>
<script>
  const topics = document.getElementById('topics');
  const values = Array.from(topics.selectedOptions, option => option.value);
  document.getElementById('result').textContent =
    `${topics.multiple}\n${values.join(',')}`;
</script>
</html>

Resultado

true
html,css

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