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.