mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 08:03:06 +00:00
73 lines
5.4 KiB
Markdown
73 lines
5.4 KiB
Markdown
# 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>/…`
|