## 3.5 Filtros: escopo, modo de exibição e filtro do conjunto

Cada filtro tem um nível, e cada nível tem um lugar *(decisão do usuário, 2026-10-22; a validar com
os analistas na página de testes)*.

| Nível | O que é | Onde fica | Exemplos |
|---|---|---|---|
| **Escopo do card** | muda do que o card trata | topo do próprio card: abas e, logo abaixo, a linha de filtros (2.24); ou a primeira etapa da listagem em duas etapas (3.18) | as visões de um relatório (Produtos, Pessoas, Equipe); o período e o produto do relatório; a pessoa cujo acesso se edita |
| **Modo de exibição** | muda como o mesmo conjunto aparece | barra de ferramentas da box, lado direito; no kanban, só Ordenar fica à direita (barra do kanban, abaixo) | Lista ou Kanban; Ordenar; Compacto; Colunas |
| **Filtro do conjunto** | reduz o que a box mostra | barra de ferramentas da box, lado esquerdo | busca; Status; Produto; Pessoa; "Só o que é meu" |

**Escopo dentro do card, não numa barra da tela** *(decisão do usuário, 2026-10-26)*. Não há barra
de ações (3.3). Num relatório, as visões são abas (2.23) no topo do card, e o período e os filtros
que mudam o recorte ficam logo abaixo delas (2.24). Tela que depende de uma escolha (a pessoa, a
fila) começa listando as opções: é a listagem em duas etapas (3.18). Nada de título na tela nem frase
explicativa no header: isso vai para a descrição da box. **Dashboard não tem filtro nem período**
(3.1): quem precisa filtrar abre um relatório.

**Barra de ferramentas da box, em até duas linhas.**
1. Primeira linha: a busca e **no máximo três filtros à vista**, os mais usados daquela tela. Os
   outros ficam no botão "Filtros", no fim da linha. Card sem título: o "Novo…" fecha a linha, no
   canto superior direito (2.1).
2. Segunda linha, só quando existe: à esquerda os chips de alternância, no máximo três; à direita o
   modo de exibição (Ordenar, Lista ou Kanban, Compacto, Colunas).
3. Linha de chips removíveis: só aparece quando há filtro ativo que não está à vista, com
   "Limpar (n)" no fim.
4. A contagem ("23 tickets") vai para o rodapé da tabela ou para a descrição da box, nunca para o
   título.

**Barra do kanban** (2.26) *(decisão do usuário, 2026-10-26)*: à esquerda, a busca, até três
filtros, "Filtros", os chips de alternância, "Lista/Kanban" e "Compacto"; à direita, só "Ordenar" e
"Nova tarefa". Na primeira linha, "Filtros" vem logo depois dos filtros à vista e "Nova tarefa"
fecha a linha; na segunda, "Lista/Kanban" e "Compacto" vêm depois dos chips, e "Ordenar" fica
sozinho à direita. Vale também para a visão em lista da mesma tela, que usa a mesma barra.

**Comportamento.**
- Filtro, busca, ordenação, aba e período **vivem na URL**: sobrevivem a recarregar a página, dão
  para compartilhar e voltam no histórico do navegador. Trocar de empresa zera tudo.
- Aplica ao mudar. O que vai ao servidor espera 300ms. Enquanto recarrega, os dados ficam e o
  Spinner aparece na barra (2.11).
- Filtro ativo sempre pode ser visto e removido sem abrir o painel: pelo gatilho, pela linha de
  chips ou por "Limpar".
- Padrão da tela ("Só o que é meu" ligado para quem atende) não é filtro escondido: aparece ligado
  no chip.
- **Celular:** a barra de ferramentas recolhe para a busca e o botão "Filtros", que abre uma folha
  de baixo com todos os campos, inclusive os que estavam à vista e os chips de alternância; o modo
  de exibição vai para o fim da folha.
- Os controles estão no componente 2.22. Exemplo vivo do card de relatório e do kanban na página do
  guia, seção 3.5; o da listagem em duas etapas, na seção 3.18.

---
Exemplo vivo: https://design.ideiabusiness.com.br#filtros · Relacionados: patterns/barra-de-acoes, components/skeleton-spinner, components/filtro, components/card-de-relatorio · Fonte: guide/patterns/filtros.md