Plano pós-gate: corrige geometria do snap (conteúdo fora da banda visível) e define load em dock (ações+busca), collapse no scroll down e reopen só por tap/pull. Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
10 KiB
Bottom drawer mobile — dock visível + recolhe no scroll
Status: rascunho
Atualizado em: 2026-08-01
Issue: —
Priority: P1
Model: composer-2.5
Impeccable: C — chrome CampaignQuickActionsDrawer: geometria do snap + comportamento scroll
Appetite: ~1 dia eng; fix de snap + dock inicial + collapse-on-scroll + e2e; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (Clarity under pressure; Feel the action; thumb zone) / DESIGN.md · dock do Início (B65) · chassis B79 · docs Base UI Drawer snap · tema data-theme='campaign'.
Na implementação (work-issue): craft compacto → critique → polish (viewport ~390; detalhe de município; scroll real no campaign-content-scroll).
Brief compacto:
- Persona / contexto: CG/assessor no celular fora do Início — precisa ver ações + busca ao chegar; ao ler o conteúdo (scroll), o chrome some para não roubar tela; volta só sob demanda.
- Job principal: (1) dock aberto o suficiente para strip + “Buscar na campanha”; (2) recolhe ao rolar a página para baixo; (3) reabre só por tap no handle ou puxar para cima.
- Estratégia de cor: Restrained —
CampaignHomeActionStrip+CampaignGlobalSearchMount. - Edit where you see: não — launchers.
- Anti-goals: auto-reabrir no scroll para cima; scrim modal; FAB; bottom nav (B73); reescrever catálogos B80–B90.
Wireframe (texto)
1) Load / idle aberto (dock):
┌─ /campanha/municipios/foo ─────────────────────┐
│ conteúdo da página │
├─ drawer DOCK (snap aberto) ────────────────────┤
│ ═ handle │
│ [●][●][●][●]… ações contextuais │
│ ┌ Buscar na campanha ────────────────────────┐ │
│ └────────────────────────────────────────────┘ │
└────────────────────────────────────────────────┘
2) Após scroll para baixo (recolhido):
┌─ página (mais conteúdo visível) ───────────────┐
│ … │
│ … │
├────────────────────────────────────────────────┤
│ ═ handle ═ ← só isso; tap / puxar ↑ reabre │
└────────────────────────────────────────────────┘
Bug de geometria a corrigir no mesmo item (expandido/dock “vazio” hoje):
conteúdo (handle+ações+busca) ↑ acima do corte do snap
────────────────────────────── ← translateY sem padding-bottom
banda visível = fundo vazio do sheet
Dados → decisão → apresentação
Dados: N/A — chrome; hits = providers B48+ via POST /campanha/home-search.
Contexto
Pedido original (2026-07-30): drawer fora do Início com ações + busca (B79–B91). Em produção o usuário não vê o conteúdo (2026-08-01) — mesmo “expandido” a banda fica vazia.
Diagnóstico: (1) geometria do snap sem o padding-bottom da receita Base UI → topo do popup fora do viewport; (2) React hidden / mount só se expanded no collapsed.
Novo comportamento de produto (2026-08-01): a página carrega com o drawer aberto o suficiente para ações + busca; ao rolar a página para baixo, recolhe para o handle; só reabre com clique no handle ou gesto de puxar para cima (não no scroll de volta ao topo).
Objetivos
- Geometria: strip + input com bounding box no viewport no snap de dock (e no handle-only o handle visível). Fix alinhado ao Base UI (
padding-bottomcompensando--drawer-snap-point-offset) sem regressão nos outros Drawers. - Dois snaps úteis:
- Dock (default no load / após navegação): handle + strip (se houver) + input de busca.
- Collapsed (após scroll down): só handle (~3rem + safe-area).
- Scroll → collapse: listener no scrollport
data-slot="campaign-content-scroll"(nãowindow); scroll para baixo além de um limiar recolhe para collapsed. - Reabrir: somente tap no handle ou drag/pull up no drawer (snap Base UI). Não reabrir automaticamente ao scrollar para cima /
scrollTop === 0. - Caso canônico:
/campanha/municipios/[slug]. - Guardrails: sem migration / Consent / action de escrita; leader lockdown intacto; Início sem este drawer.
- Tracer bullet: e2e mobile — load com busca
toBeInViewport→ scroll down → busca fora / handle visível → click handle → busca de volta no viewport.
Decisões travadas
- Dois snaps: dock (ações+busca) e collapsed (handle). Pedido 2026-08-01. O antigo “expanded 0.55dvh” deixa de ser o default; se a busca ativa precisar de mais altura, crescer o dock ou um 3º snap só com query/focus (ver Questões). Rejeitado: três snaps no idle; default collapsed (esconde o ritual); always-expanded sem collapse no scroll.
- Collapse só no scroll para baixo do content scrollport; reopen só gesto no drawer. Rejeitado: toggle automático no scroll-up (usuário pediu o contrário); escutar
window(o scroll real é o flex child); hysteresis complexa multi-eixo neste item. - Estado inicial = dock a cada navegação de rota (remount / pathname change). Rejeitado: persistir collapsed em
sessionStorageneste item (Adiado — primeiro entregar o ritual). - Corrigir geometria do snap (causa do sheet vazio) no mesmo delivery. Preferência: receita Base UI com
padding-bottom; ajuste no primitivoDrawer.tsxse for o gap documentado, senão override no chassis. Rejeitado: só CSS cosmético sem fix de offset; abandonar Drawer porfixedcaseiro. - i18n: ids em inglês (
dock/collapsedsnaps); aria pt-BR (“Mostrar/Ocultar ações rápidas”).
Questões em aberto
- Limiar de scroll para recolher? Opções: A)
scrollTop > 24| B) delta para baixo ≥ 16 px numa gesture. Recomendação: A — simples, previsível, fácil de pinar no e2e. (assumido) - Busca com query ativa / focus: manter dock aberto e ignorar collapse? Opções: A) sim — não recolher enquanto
inputFocused || query.isActive| B) recolher mesmo assim. Recomendação: A — senão o teclado + resultados somem no meio da busca. (assumido) - 3º snap alto só para resultados? Opções: A) não neste item — resultados rolam dentro do dock | B) expandir no focus. Recomendação: A no appetite; B se o critique mostrar resultados cortados. (assumido)
Abordagem proposta
flowchart TB
nav["pathname change"] --> dock["snap = DOCK\nstrip + search visíveis"]
dock --> scroll["scrollTop content > limiar\ne busca idle"]
scroll --> collapsed["snap = COLLAPSED\nsó handle"]
collapsed --> gesture["tap handle / pull up"]
gesture --> dock
geo["fix padding-bottom / altura snap"] --> dock
Componentes:
campaignQuickActionSnap.ts: renomear/clarificarDOCK(altura fixa medida para strip+input, ~10–14rem) eCOLLAPSED(3rem); atualizar padding do scroll (--campaign-quick-actions-peek) — peek do layout = collapsed (reserva mínima); quando dock aberto, padding maior ou medido para não cobrir o fim da página.CampaignQuickActionsDrawer: defaultsnapPoint = DOCK; conteúdo do dock sempre montado (semhiddenque esconde ações/busca); collapsed só esconde/compacta via altura do snap (geometria correta), não viadisplay:nonedo bloco útil se isso quebrar a medida — preferir deixar o conteúdo no DOM e deixar o snap clipar desde que o padding-bottom Base UI mantenha o topo na banda quando dock.- Scroll → collapse: em
CampaignQuickActionsHost/ drawer,useEffectno elemento[data-slot=campaign-content-scroll](scrolllistener, passive); sescrollTop > THRESHOLDe busca idle →setSnapPoint(COLLAPSED); não setar DOCK no scroll up. Drawer.tsx(se necessário):padding-bottom: max(0px, calc(var(--drawer-snap-point-offset) + var(--drawer-swipe-movement-y)))sobdata-snap-points; revisar conflito100dvhvsmax-h; smoke nos Drawers com snap.- Testes: unit — default dock mostra busca sem click; scroll mock recolhe; scroll up não reabre. e2e mobile no detalhe de município com
toBeInViewport. - Migration: nenhuma.
Dependências
- Soft (entregues): B79, B80, B91, B73.
- Serializa com outros
Drawer+snap se o fix for global.
Não escopo
- Catálogos B80–B90 / registry.
- Início (
CampaignHomeLayout) — paridade visual só como referência; não aplicar collapse-on-scroll no Início neste item. - Desktop /
md+. - Persistência de snap entre rotas.
- B99 (edge-to-edge da strip).
Rabbit holes
- IntersectionObserver / scroll velocity / hide-on-idle. Mitigação: um limiar de
scrollTop, ponto. - Reimplementar snap. Mitigação: Base UI + CSS documentado.
- Padding do scroll desafinado (conteúdo sob o dock). Mitigação: CSS var por estado (dock vs collapsed) no
CampaignContentScroll; medir no polish. - Teclado iOS. Mitigação: busca ativa bloqueia collapse; polish em device.
Adiado com gatilho
- Persistir collapsed entre navegações. Revisitar se o CG reclamar de reabrir o dock a cada rota.
- 3º snap / grow no focus da busca. Revisitar se resultados ficarem cortados no dock.
- Reabrir ao voltar ao topo (
scrollTop === 0). Só se produto pedir depois — hoje rejeitado.
Referências
- Docs Base UI Drawer snap — padding-bottom + offset
src/components/ui/Drawer.tsx·CampaignQuickActionsDrawer.tsx·CampaignQuickActionsHost.tsxsrc/lib/campaignQuickActionSnap.tsdata-slot="campaign-content-scroll"— scrollporttests/unit/campaignQuickActionsDrawer.unit.spec.tsxdocs/plans/chassis-bottom-drawer-acoes-rapidas.md·busca-global-bottom-drawer.mdPRODUCT.md/DESIGN.md
Revisões
- 2026-08-01: Gap de visibilidade pós-B79/B91.
- 2026-08-01 (b): Causa raiz = geometria do snap (conteúdo fora da banda).
- 2026-08-01 (c): Produto — load em dock (ações+busca); collapse no scroll down; reopen só tap/pull.