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

5.4 KiB
Raw Permalink Blame History

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>/…