5.4 KiB
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— inputtext-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=1global 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 (incluicontenteditable/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-scaleseletivo como fallback - t3code PR #1652 — padrão
text-baseno mobile comsm: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)
- West-Wind (2023) — "Preventing iOS Textbox Auto Zooming": limiar 16px +
- Código:
src/components/campaign/shared/CampaignListOmnibox.tsx(inputtext-sm, linha ~225), formulários emsrc/app/(campaign)/campanha/(app)/…esrc/components/campaign/<domínio>/…