CKTIS / HTML
multiple — plusieurs valeurs dans un contrôle de formulaire
L’attribut booléen `multiple` permet de choisir plusieurs options dans `select`, de saisir plusieurs adresses dans un champ `email` ou de sélectionner plusieurs fichiers dans un champ `file`. C’est la présence de l’attribut, et non le texte de sa valeur, qui détermine le comportement.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".multiple est un attribut booléen : sa présence active le comportement et son absence le désactive. Les formes valides sont multiple, multiple="" et multiple="multiple". Écrire multiple="false" est incorrect et active tout de même le comportement, puisque l’attribut est présent. Pour le désactiver, supprimez l’attribut.
Sur select, il permet de sélectionner zéro option ou plus ; sans lui, le contrôle sert à sélectionner une seule option. Il ne sélectionne pas automatiquement toutes les options. L’attribut size détermine le nombre d’options visibles, et non la limite de sélection.
Sur un champ email, il permet une liste d’adresses séparées par des virgules, et non par des points-virgules. Sur un champ file, il permet de sélectionner plusieurs fichiers ; sans lui, la liste des fichiers sélectionnés peut en contenir au maximum un. Ce n’est pas un mécanisme général permettant de saisir plusieurs valeurs dans les autres types de input.
L’exemple contient deux options avec l’attribut selected. Le script lit la propriété multiple et les valeurs de selectedOptions, puis affiche le résultat initial. Aucune sélection manuelle n’est nécessaire.
Exemples
<!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>Résultat
true html,css
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.