Listbox
casella di elenco
Una listbox è un elenco personalizzato di scelte. Gestisce quale scelta è attiva e come i tasti freccia si muovono attraverso l'elenco.
Un esempio vero
Un dispatcher sceglie un deposito tra 180 risultati ricercabili. I tasti freccia permettono di scorrere le opzioni e Invio seleziona una. Dopo il filtraggio, un lettore di schermo annuncia ancora il deposito selezionato. Una lista breve fissa dovrebbe usare invece un `<select>` integrato.
Parti principali
- 01contenitore casella di elenco
- 02opzione attiva
- 03Stato della selezione
Usalo quando
Crea una listbox personalizzata solo quando un `<select>` predefinito non può gestire ricerca, opzioni ricche o la selezione di più elementi.
Non usarlo quando
Non mettere pulsanti, link o altri controlli separati all'interno di un'opzione.
Nome usato nel codice
role=listbox + role=option + aria-selected + roving focus/aria-activedescendant Prima di spedire
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 casella di elenco (Listbox). User context: Un dispatcher sceglie un deposito tra 180 risultati ricercabili. I tasti freccia permettono di scorrere le opzioni e Invio seleziona una. Dopo il filtraggio, un lettore di schermo annuncia ancora il deposito selezionato. Una lista breve fissa dovrebbe usare invece un `<select>` integrato. Recommended pattern: casella di elenco (Listbox). Why it fits: Crea una listbox personalizzata solo quando un `<select>` predefinito non può gestire ricerca, opzioni ricche o la selezione di più elementi. Do not use it when: Non mettere pulsanti, link o altri controlli separati all'interno di un'opzione. 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): È ufficiale per quella fonte. Altre piattaforme o team potrebbero usare il termine in modo diverso. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Controlla questa richiesta
Review how casella di elenco (Listbox) is used now. Definition: Una listbox è un elenco personalizzato di scelte. Gestisce quale scelta è attiva e come i tasti freccia si muovono attraverso l'elenco. 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.