Listbox
zone de liste
Une liste déroulante est une liste personnalisée de choix. Elle gère quel choix est actif et comment les touches fléchées se déplacent dans la liste.
Un vrai exemple
Un répartiteur choisit un dépôt parmi 180 résultats consultables. Les touches fléchées permettent de parcourir les choix, et Entrée sélectionne un dépôt. Après filtrage, un lecteur d'écran annonce toujours le dépôt choisi. Une liste fixe courte devrait utiliser un `<select>` intégré à la place.
Parties principales
- 01conteneur de zone de liste
- 02Option active
- 03état de sélection
Utilisez-le lorsque
Construisez une liste déroulante personnalisée uniquement lorsqu'un `<select>` intégré ne peut pas gérer la recherche, les choix enrichis ou la sélection de plusieurs articles.
Ne l'utilisez pas lorsque
Ne mettez pas de boutons, de liens ou d'autres contrôles séparés à l'intérieur d'une option.
Nom utilisé dans le code
role=listbox + role=option + aria-selected + roving focus/aria-activedescendant Avant d'expédier
Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages.
Outcome: Complete the task with zone de liste (Listbox). User context: Un répartiteur choisit un dépôt parmi 180 résultats consultables. Les touches fléchées permettent de parcourir les choix, et Entrée sélectionne un dépôt. Après filtrage, un lecteur d'écran annonce toujours le dépôt choisi. Une liste fixe courte devrait utiliser un `<select>` intégré à la place. Recommended pattern: zone de liste (Listbox). Why it fits: Construisez une liste déroulante personnalisée uniquement lorsqu'un `<select>` intégré ne peut pas gérer la recherche, les choix enrichis ou la sélection de plusieurs articles. Do not use it when: Ne mettez pas de boutons, de liens ou d'autres contrôles séparés à l'intérieur d'une option. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): C'est officiel pour cette source. D'autres plateformes ou équipes peuvent utiliser le terme d'une autre manière. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Vérifiez cette demande
Review how zone de liste (Listbox) is used now. Definition: Une liste déroulante est une liste personnalisée de choix. Elle gère quel choix est actif et comment les touches fléchées se déplacent dans la liste. Release checks: Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.