aria-multiselectable
Indique que l'utilisateur peut sélectionner plusieurs éléments dans un widget de liste ou de grille.
Description
aria-multiselectable="true" est placé sur le conteneur d’un widget de sélection (listbox, grid, tree, tablist) pour indiquer que plusieurs éléments peuvent être sélectionnés simultanément. Chaque option sélectionnable utilise alors aria-selected.
Syntaxe
<ul role="listbox" aria-multiselectable="true" aria-label="Tags disponibles">
<li role="option" aria-selected="true">HTML</li>
<li role="option" aria-selected="true">CSS</li>
<li role="option" aria-selected="false">JavaScript</li>
</ul>
Exemples
Liste de fichiers à sélection multiple :
<ul role="listbox"
aria-multiselectable="true"
aria-label="Fichiers — sélection multiple avec Maj+clic">
<li role="option" aria-selected="false" tabindex="0">rapport-2024.pdf</li>
<li role="option" aria-selected="true" tabindex="-1">facture-001.pdf</li>
<li role="option" aria-selected="true" tabindex="-1">facture-002.pdf</li>
</ul>
Notes
Combiner avec aria-selected : chaque item sélectionnable doit avoir aria-selected="true" ou aria-selected="false" — ne pas omettre la valeur false.
Équivalent HTML : <select multiple> gère nativement la multi-sélection. N’utiliser aria-multiselectable que pour des widgets personnalisés.
Instructions utilisateur : documenter la méthode de sélection multiple (Maj+clic, Ctrl+clic) via aria-label ou aria-describedby sur le conteneur.