Filter
Filtro
Um filter é um controle ou regra que mostra só os itens que correspondem às condições escolhidas. Ele não muda os dados originais.
Um exemplo real
Uma lista de tarefas mostra o trabalho não terminado que vence esta semana e está atribuído ao usuário atual. Os filtros ativos continuam visíveis.
Partes principais
- 01Rótulo visível
- 02Interaction target
- 03Current state
- 04Keyboard behavior
Use-o quando
Use-o quando as pessoas frequentemente precisarem de conjuntos menores úteis de uma grande coleção.
Não o use quando
Nunca esconda filtros padrão. Deixe as pessoas desfazerem a filtragem e remover os filtros claramente.
Nome usado no código
query params / predicate Antes de lançar
Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery.
Outcome: Complete the task with Filtro (Filter). User context: Uma lista de tarefas mostra o trabalho não terminado que vence esta semana e está atribuído ao usuário atual. Os filtros ativos continuam visíveis. Recommended pattern: Filtro (Filter). Why it fits: Use-o quando as pessoas frequentemente precisarem de conjuntos menores úteis de uma grande coleção. Do not use it when: Nunca esconda filtros padrão. Deixe as pessoas desfazerem a filtragem e remover os filtros claramente. 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): Nenhum padrão oficial único controla todo o termo. Seu significado pode mudar entre equipes, plataformas ou frameworks. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Filtro (Filter) is used now. Definition: Um filter é um controle ou regra que mostra só os itens que correspondem às condições escolhidas. Ele não muda os dados originais. Release checks: Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.