teqo-backup/docs/plans/pwa-ios-autozoom-input-foco.md

73 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# PWA iOS: foco na omnibox de filtros aplica auto-zoom que não volta
Status: ready
Atualizado em: 2026-08-09
Issue: #501
Priority: P1
Model: composer-2.5
Model-local: deepseek-v4-flash-high
Impeccable: A — N/A (bug fix; restaura o comportamento esperado, sem redesenho)
Canvas UI: N/A — sem UI nova
Appetite: ~0,5–1 dia eng
Responsável: —
## Intenção
No PWA `/campanha` no iPhone: ao tocar na omnibox de filtros (ex. lista de Municípios), o Safari aproxima a tela no input; ao terminar de digitar, a tela fica nessa perspectiva aproximada, com as laterais do app cortadas — o usuário precisa perceber e desfazer o zoom na mão.
Causa conhecida e documentada: o Safari iOS aplica auto-zoom em qualquer input com font-size renderizado menor que 16px ao focar, e no PWA standalone nem sempre restaura a escala ao fechar o teclado. A omnibox das listas usa `text-sm` (14px) — abaixo do limiar. O mesmo vale para outros inputs do app (login, formulários, wizard), que podem reproduzir o mesmo comportamento.
## Persona e fluxo
- **Persona / contexto:** staff da campanha (coordinator/advisor) no campo, filtrando listas (`/campanha/municipios`, `/campanha/apoiadores`, `/campanha/liderancas`, etc.) no iPhone.
- **Job principal:** filtrar e seguir trabalhando, sem o app "desarrumar" a tela.
- **Fluxo desejado:** toca na omnibox → teclado abre → digita e escolhe filtro → teclado fecha → tela exatamente como estava, na mesma escala.
- **Anti-goals de produto:** não é redesenho da omnibox; não é "subir o texto para 16px no desktop".
## Objetivo e aceite
- Tocar na omnibox (e em qualquer input do PWA: login, filtros, formulários, wizard) não provoca zoom automático no iPhone.
- Após fechar o teclado, a página permanece na escala original — sem corte de laterais, sem "desfazer zoom" manual.
- No desktop e em telas maiores, a aparência dos inputs continua como hoje (a fonte maior vale só onde o trigger do iOS existe).
- Nenhuma mudança de layout/visual além do tamanho de fonte dos campos no mobile, quando necessária.
## Dados (intenção)
- **Vou apresentar dados?** Não — bug de interação; verificação visual no aparelho.
- **Decisões desbloqueadas:** nenhuma para o produto.
## Direção no codebase (hipótese)
- **Áreas prováveis:** `CampaignListOmnibox` (`src/components/campaign/shared/CampaignListOmnibox.tsx` — input `text-sm`; chassis compartilhado por todas as listas: `MunicipalityFilters`, `SupporterFilters`, `LeadershipFilters`, `TerritoryFilters`, `StateDeputyFilters`, `OrganizationFilters`, `CampaignUpdatesFilters`, `ActivityFilters`…); demais inputs dos formulários de `/campanha` (login, wizard de liderança, modais de criação) — o trigger é o mesmo, então o fix provavelmente é uma regra única para inputs do PWA no touch/mobile, não um ajuste campo a campo.
- **Precedente a olhar:** fixos externos documentados (West-Wind, t3code PR #1652, BookStack #5935) — padrão `16px no mobile, tamanho original no desktop` (`sm:` override) ou regra global de inputs.
- **Risco de acoplamento:** a omnibox é usada por ~8 listas com o mesmo chassis — mudança no componente compartilhado cobre todas de uma vez; não duplicar o fix por lista.
## Dependências
- Nenhuma dura. Suave: reduz a frequência do B182 (zoom preso) ao eliminar o trigger — podem ser executados em qualquer ordem.
## Fora de escopo
- Redesenho da omnibox ou das listas.
- Corrigir o estado "zoom preso" em si quando ele vier de outras fontes (isso é o B182).
- Inputs do site público (fora do PWA `/campanha`), salvo se reproduzirem e for trivial.
## Rabbit holes de produto
- **Caçar todos os inputs do app um a um.** O trigger é sistêmico (regra do iOS por font-size), então fix pontual por componente vira whack-a-mole. **Corte neste item:** regra única para inputs do PWA no mobile + verificação amostral (omnibox, login, um formulário), não inventário exaustivo.
- **Virar debate de acessibilidade de zoom global.** `maximum-scale=1` global resolve mas degrada; aqui a regra de 16px é suficiente e não bloqueia nada. **Corte:** sem política de escala global neste item (se precisar, vive no B182 como fallback).
## Questões em aberto (produto)
- ~~Aplicar 16px em todos os inputs ou só na omnibox?~~ **Decidido no gate (2026-08-09): todos de uma vez** — regra única para inputs do PWA no mobile/PWA (inclui `contenteditable`/select), cobrindo omnibox, login, formulários e wizard com o mesmo trigger.
- **O texto dos campos ficar maior no iPhone é aceitável?** **Opções:** A) sim, 16px é padrão de leitura em mobile; B) compensar visualmente com layout. **Recomendação:** A — 16px é o tamanho de input padrão no iOS; mudança perceptível mas coerente. _(assumido — validar com produto)_
## Referências
- GitHub Issue #501
- Pesquisa externa (reaproveitável pelo executor):
- West-Wind (2023) — "Preventing iOS Textbox Auto Zooming": limiar 16px + `maximum-scale` seletivo como fallback
- t3code PR #1652 — padrão `text-base` no mobile com `sm:` override para desktop
- BookStack #5935 — zoom preso no PWA iOS ao editar texto; lista de workarounds
- dev.to (cederhook, 2026-07) — contexto do viewport standalone preso pós-teclado (parente do B182)
- Código: `src/components/campaign/shared/CampaignListOmnibox.tsx` (input `text-sm`, linha ~225), formulários em `src/app/(campaign)/campanha/(app)/…` e `src/components/campaign/<domínio>/…`