Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

multiple — più valori in un controllo del modulo

L’attributo booleano `multiple` consente di scegliere più opzioni in `select`, inserire più indirizzi in un campo `email` o selezionare più file in un campo `file`. Il comportamento dipende dalla presenza dell’attributo, non dal testo del suo valore.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

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

multiple è un attributo booleano: la sua presenza abilita il comportamento e la sua assenza lo disabilita. Le forme valide sono multiple, multiple="" e multiple="multiple". Scrivere multiple="false" non è valido e abilita comunque il comportamento, perché l’attributo è ancora presente. Per disabilitarlo, rimuovi l’attributo.

Su select, consente di selezionare zero o più opzioni; senza di esso, il controllo serve a selezionare una sola opzione. Non seleziona automaticamente tutte le opzioni. L’attributo size determina quante opzioni sono visibili, non il limite di selezione.

Su un campo email, consente un elenco di indirizzi separati da virgole, non da punti e virgola. Su un campo file, permette di selezionare più file; senza di esso, l’elenco dei file selezionati può contenerne al massimo uno. Non è un meccanismo generale per inserire più valori negli altri tipi di input.

L’esempio contiene due opzioni con l’attributo selected. Lo script legge la proprietà multiple e i valori da selectedOptions, quindi visualizza il risultato iniziale. Non è necessario selezionare le opzioni manualmente.

Esempi

<!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>

Risultato

true
html,css

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti