Cascader
Cascader
Um Cascader mostra as escolhas um nível de cada vez. Uma escolha abre a próxima lista correspondente.
Um exemplo real
Um formulário de entrega pede país, estado e cidade. Cada resposta estreita a próxima lista.
Partes principais
- 01Acionar
- 02Colunas de nível
- 03Caminho selecionado
Use-o quando
Use-o quando as escolhas formarem uma árvore estável e cada nível tiver um caminho claro.
Não o use quando
Evite usar para listas curtas, buscas entre diferentes áreas ou rótulos que precisam de contexto extra.
Nome usado no código
tree path + dependent option columns 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 Cascader (Cascader). User context: Um formulário de entrega pede país, estado e cidade. Cada resposta estreita a próxima lista. Recommended pattern: Cascader (Cascader). Why it fits: Use-o quando as escolhas formarem uma árvore estável e cada nível tiver um caminho claro. Do not use it when: Evite usar para listas curtas, buscas entre diferentes áreas ou rótulos que precisam de contexto extra. 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): Isto não é um padrão normativo. Seu nome, limites e comportamento esperado podem mudar de uma fonte para outra. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Cascader (Cascader) is used now. Definition: Um Cascader mostra as escolhas um nível de cada vez. Uma escolha abre a próxima lista correspondente. 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.