Acabamento mobile: aprendizados do Atlas Mobile (primeira execução, título de aba, lista agrupada, vazio com próximo passo, erro para pessoas, painel de status, sem salto de layout)

未关闭
#1,330 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript
领域
design, frontend

调研方向

Read the linked Atlas Mobile review (#435), the reference implementation in lib/core/ui/, and linked library issues #1238, #1174, and #1104. The request spans ten proposed components, recipes, and testing tools, so first identify one item to split into a focused issue. Done means each focused item has its component or recipe and a test that reproduces the described defect.

由索引模型根据 Issue 内容生成。

描述

area:components enhancement

Contexto

Revisão de produto do Atlas Mobile num iPhone real (codeatlasdev/atlas#435). O app é Flutter, então não usa a lib, mas as falhas que o dono viu são de padrão e não de framework, e a lib promete "native-feeling mobile". Cada item abaixo diz o que quebrou, a regra que resolveu, o que a lib deveria oferecer (componente, receita ou lint) e as issues abertas ligadas. A implementação de referência em Flutter está no PR citado (lib/core/ui/).

O critério do dono: nada pode parecer "vibecodado". Botão solto, faixa sobre conteúdo, vazio que só informa e número que rola de lado são defeitos.


1. Primeira execução não mora dentro de uma aba

Quebrou: o onboarding era o conteúdo da aba Home, então a tab bar flutuante ficou por cima de Continue e Skip e ofereceu abas sem nada para mostrar.
Regra: a primeira execução é do shell. Ela fica em tela cheia, com as abas montadas por baixo (offstage, sem tickers) para a Home já estar conectando quando o fluxo acaba. Uma regra só decide isso (no Atlas: nada pareado), sem escrita de estado a partir de build.
Para a lib: AppShellLayout com um modo fullscreen/firstRun que esconde a navegação e mantém as rotas vivas por baixo, mais um teste de contrato: nenhum botão primário pode estar sob a barra (hit-test). Ligadas: #1238, #1174, #1104.

2. Título de aba com os controles na mesma linha

Quebrou: cada aba montava o título à mão, com paddings diferentes. Na aba Crew, "Pause all" e o botão de opções flutuavam soltos abaixo do título.
Regra: um componente de linha de título. Ele tem altura mínima de 48, o título como header na árvore de acessibilidade e as ações da tela à direita. Todas as abas abrem igual. Quando há várias entidades (vários servidores), vira uma linha nomeada por entidade abaixo do título.
Para a lib: PageTitle/TabTitle mobile com slot de ações e regra de overflow (as ações viram menu quando não cabem). Ligadas: #1044, #1107, #736.

3. Lista agrupada estilo ajustes

Quebrou: Settings era um card, um link e uma linha de privacidade, com um vazio enorme embaixo.
Regra: grupos com título em muted e rodapé opcional (uma frase do porquê). As linhas são:

  • ícone num tile tingido de 32 px;
  • título e subtítulo;
  • altura mínima de 56;
  • divisor com recuo que começa no texto, não na borda.

O fim da linha diz o tipo: chevron navega, seta "↗" abre fora (com link na semântica), "info" mostra valor sem ação, e um trailing (menu, switch) reduz o padding final para o ícone cair onde o chevron cairia. Uma linha de status aceita um ponto de estado antes do subtítulo.
Para a lib: NativeList / GroupedList com esses tipos de linha. Ligadas: #1133, #1239, #1161.

4. Estado vazio sempre leva a algum lugar

Quebrou: a aba Crew sem servidor dizia "No crew yet" e parava ali.
Regra: vazio, não configurado, erro e carregando são estados diferentes, e cada um tem o próximo passo:

  • Não configurado: explica o recurso em uma frase, oferece a ação primária ("Pair a crew server") e um link de guia ("How to install a crew server ↗").
  • Vazio: oferece a ação de criar (Recruit).
  • Carregando: nunca mostra "vazio".

Para a lib: EmptyState com guide={label, href} além de action, e uma receita que nomeia os quatro estados. Ligadas: #992, #1060, #1198.

5. Erro dito para pessoas

Quebrou: erros mostravam o texto cru do servidor ("forbidden", stack de Rust).
Regra: um objeto Problem com título, uma frase, passos numerados (comandos entre crases viram chip de código) e o texto cru em "Details" recolhido e copiável. A classificação por tipo dá títulos estáveis:

  • offline: "Can't reach X";
  • versão: "Atlas on X is out of date";
  • permissão: "This phone isn't allowed to do that";
  • timeout.

As ações ficam num Wrap, porque "Try again" mais "Details" estourou em 320 pt.
Para a lib: ErrorState/Problem com essa forma, mais um teste de layout em 320 px com texto 2x. Ligada: #1290 (detector de texto cru).

6. Painel de status: estado, a ação dele e os números num bloco

Quebrou (print do dono): a pílula "Stopped" e um "Start" grande ficavam lado a lado soltos acima de um card de números. Um projeto parado mostrava "0/6 running" em vermelho.
Regra:

  • Um painel com o estado em palavras ("Stopped · 6 services, none running", ou "Running · up 1h 20m · pid 4821") e a sua única ação (Start, que vira "Starting…" desabilitado em voo), com divisor e os números embaixo.
  • Parado não é alarme: 0/6 fica neutro, e memória e CPU de nada são "—", não "0 MB".
  • Números nunca rolam de lado: cada KPI tem largura natural, distribuídos com spaceBetween e quebrando linha quando não cabem. Colunas iguais colaram "646 MB18%".

Para a lib: receita StatusPanel e KpiRow com essas regras de semântica (cor só quando há ação a tomar). Ligadas: #1157, #486, #55.

7. Nada muda de altura enquanto os dados chegam

Quebrou (os testes de frame pegaram):

  • A linha "Connected · Atlas 1.0.0" quebrava em duas quando a versão chegava e empurrava a página.
  • Uma linha de notificações nova pulou 114 px num frame.
  • Um placeholder de altura mágica (64) não batia com a linha real.

Regra:

  • Linha de status ao vivo é maxLines: 1 com reticências.
  • Conteúdo que entra abre o espaço animando (um passo só com Reduce motion), nunca de uma vez.
  • O placeholder é o mesmo widget invisível, não uma altura fixa, então segura a altura certa em qualquer escala de texto.

Para a lib: um primitivo GrowIn/MotionSize, e uma regra de lint para "skeleton tem a forma do conteúdo". Ligadas: #1068, #1197.

8. Chão do app sob todas as rotas

Quebrou: com os scaffolds transparentes (fundo compartilhado com brilho), sheet e tela sem fundo próprio mostravam a janela por trás (branco nos goldens, preto no aparelho).
Regra: um "chão" (ground) no builder do app, sob todas as rotas, e o fundo decorado por cima.
Para a lib: documentar a camada de chão vs o fundo de página no tema, e garantir que todo overlay herde o chão. Ligada: #1299.

9. Links externos num lugar só

Quebrou: a política de privacidade apontava para o GitHub enquanto o site tinha a página. URLs espalhadas.
Regra: um módulo de links (site, docs por página e âncora, privacidade, código), e openLink sempre no navegador.
Para a lib: uma receita de "links do produto", e o tipo "external" da linha (item 3) usando o mesmo helper.

10. Como pegamos tudo isso sem olhar tela por tela
  • Harness de layout: toda tela em 320×568, 360×640 e 393×852, com texto 1x e 2x, notch e home indicator. Falha em overflow.
  • Frame probe: grava a posição de partes nomeadas frame a frame e falha se algo pula mais que uma fração do movimento, ou se duas páginas aparecem ao mesmo tempo.
  • Tour headless: um teste que carrega a fonte do sistema e grava PNG de 13 telas em 7 s, para revisão de design sem aparelho.
  • Mutation check: todo teste novo foi visto falhando com o bug reintroduzido.

Para a lib: é o pacote de detectores de #1290, mais o tour como modo do site (todas as receitas em 3 larguras e 2 escalas de texto, num lugar só).


Aceite sugerido: cada item vira uma issue própria, ou fecha numa issue ligada. A lib publica, para cada um, o componente ou a receita, mais um teste que falha no defeito descrito.

主要语言
TypeScript
星标
6
派生
3
平均合并
5 小时 21 分钟
30 天内合并 PR
378

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

codeatlasdev/ui 的其他 Issue

查看 codeatlasdev/ui 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。