Listbox
caixa de listagem
Uma lista suspensa é uma lista personalizada de escolhas. Ela gerencia qual escolha está ativa e como as teclas de seta se movem pela lista.
Um exemplo real
Um despachante seleciona um depósito entre 180 resultados pesquisáveis. As teclas de seta movem entre as opções, e Enter escolhe uma. Após o filtro, um leitor de tela ainda anuncia o depósito escolhido. Uma lista curta e fixa deve usar um `<select>` incorporado em vez disso.
Partes principais
- 01contêiner de caixa de listagem
- 02Opção ativa
- 03Estado de seleção
Use-o quando
Crie uma lista personalizada apenas quando um `<select>` integrado não puder lidar com pesquisa, escolhas ricas ou seleção de vários itens.
Não o use quando
Não coloque botões, links ou outros controles separados dentro de uma opção.
Nome usado no código
role=listbox + role=option + aria-selected + roving focus/aria-activedescendant Antes de lançar
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 caixa de listagem (Listbox). User context: Um despachante seleciona um depósito entre 180 resultados pesquisáveis. As teclas de seta movem entre as opções, e Enter escolhe uma. Após o filtro, um leitor de tela ainda anuncia o depósito escolhido. Uma lista curta e fixa deve usar um `<select>` incorporado em vez disso. Recommended pattern: caixa de listagem (Listbox). Why it fits: Crie uma lista personalizada apenas quando um `<select>` integrado não puder lidar com pesquisa, escolhas ricas ou seleção de vários itens. Do not use it when: Não coloque botões, links ou outros controles separados dentro de uma opção. 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): É oficial para essa fonte. Outras plataformas ou equipes podem usar o termo de outra maneira. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how caixa de listagem (Listbox) is used now. Definition: Uma lista suspensa é uma lista personalizada de escolhas. Ela gerencia qual escolha está ativa e como as teclas de seta se movem pela lista. 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.