Passer au contenu principal

ListBox

Ouvrir dans ChatGPT
Ombre dwc-listbox 23.05
Java API

Le composant ListBox affiche une liste d'éléments défilable qui reste visible sans avoir besoin d'ouvrir un menu déroulant. Il prend en charge à la fois la sélection simple et multiple, et fonctionne bien lorsque les utilisateurs ont besoin de voir toutes les options disponibles en une seule fois.

Usages​

Inheritance

This class is a List component, and inherits its features and behaviors. For an overview of List properties, events, and other important information, please refer to the List documentation.

  1. Affectation de Rôle Utilisateur : Dans les applications avec contrôle d'accès utilisateur, les administrateurs peuvent utiliser un ListBox pour attribuer des rôles et des permissions aux utilisateurs. Les utilisateurs sont sélectionnés dans une liste, et les rôles ou permissions sont attribués en fonction de leur sélection. Cela garantit un accès précis et contrôlé à différentes fonctionnalités et données au sein de l'application.

  2. Affectation de Tâches de Projet : Dans les logiciels de gestion de projet, les composants ListBox sont utiles pour attribuer des tâches aux membres de l'équipe. Les utilisateurs peuvent sélectionner des tâches dans une liste et les assigner à différents membres de l'équipe. Cela simplifie la délégation des tâches et garantit que les responsabilités sont clairement définies au sein de l'équipe.

  3. Filtrage Multi-Catégories : Dans une application de recherche, les utilisateurs ont souvent besoin de filtrer les résultats de recherche sur la base de plusieurs critères. Un ListBox peut afficher diverses options de filtrage, telles que

  • Caractéristiques du produit
  • Plages de prix
  • Marques.

Les utilisateurs peuvent sélectionner des éléments dans chaque catégorie de filtre, leur permettant de affiner les résultats de recherche et de trouver exactement ce qu'ils recherchent.

  1. Catégorisation de Contenu : Dans les systèmes de gestion de contenu, les composants ListBox aident à catégoriser les articles, images ou fichiers. Les utilisateurs peuvent sélectionner une ou plusieurs catégories à associer à leur contenu, facilitant ainsi l'organisation et la recherche d'éléments de contenu dans le système.

Options de Sélection​

Par défaut, le ListBox est configuré pour permettre la sélection d'un seul élément à la fois. Cependant, le ListBox implémente l'interface MultipleSelectableList, qui peut être configurée avec une méthode intégrée permettant aux utilisateurs de sélectionner plusieurs éléments en utilisant la touche Shift pour une sélection contiguë et la touche Control (Windows) ou Command (Mac) pour une sélection multiple d'éléments séparés.

Utilisez la fonction setSelectionMode() pour changer cette propriété. Cette méthode accepte soit SelectionMode.SINGLE soit SelectionMode.MULTIPLE.

Comportement sur appareils tactiles

Sur les appareils tactiles, lorsque la sélection multiple est activée, les utilisateurs peuvent sélectionner plusieurs éléments sans maintenir la touche shift.

De plus, les touches fléchées peuvent être utilisées pour naviguer dans le ListBox, et taper une lettre lorsque le ListBox a le focus sélectionnera l'option qui commence par cette lettre, ou fera défiler les options commençant par cette lettre si plusieurs options existent.

Afficher le code

Style​

Loading...

Meilleures Pratiques​

Pour garantir une expérience utilisateur optimale lors de l'utilisation du composant ChoiceBox, considérez les meilleures pratiques suivantes :

  1. Priorisez la Hiérarchie de l'Information : Lorsque vous utilisez un ListBox, assurez-vous que les éléments sont organisés dans un ordre logique et hiérarchique. Placez les options les plus importantes et les plus couramment utilisées en haut de la liste. Cela permet aux utilisateurs de trouver ce dont ils ont besoin sans faire défiler excessivement.

  2. Limitez la Longueur de la Liste : Évitez de submerger les utilisateurs avec un ListBox excessivement long. S'il y a un grand nombre d'éléments à afficher, envisagez d'implémenter une pagination, une recherche ou des options de filtrage pour aider les utilisateurs à localiser les éléments rapidement. Alternativement, vous pouvez regrouper les éléments en catégories pour réduire la longueur de la liste.

  3. Étiquettes Claires et Descriptives : Fournissez des étiquettes claires et descriptives pour chaque élément dans le ListBox. Les utilisateurs doivent pouvoir comprendre l'objectif de chaque option sans ambiguïté. Utilisez des étiquettes d'élément concises et significatives.

  4. Feedback de Sélection Multiple : Si votre ListBox permet des sélections multiples, fournissez un retour visuel ou textuel indiquant que plusieurs éléments peuvent être sélectionnés dans la liste.

  5. Sélection par Défaut : Envisagez de définir une sélection par défaut pour le ListBox, surtout si une option est plus couramment utilisée que les autres. Cela peut rationaliser l'expérience utilisateur en pré-sélectionnant le choix le plus probablement attendu.