prose: code inline quebra no meio do identificador no celular (overflow-wrap: anywhere) e parte o chip

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
72/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
typescript
领域
design, frontend

调研方向

Start with the .ca-prose inline code rule in packages/ui/src/lib/styles/prose.css and inspect the existing layout coverage in apps/docs/tests/layout.spec.ts. Reproduce the reported wrapping at 320, 390, and 768px, including narrow table cells. Done means inline code that fits the column stays on one line without splitting its chip, while longer tokens wrap only as specified.

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

描述

area:docs area:theme bug

Problema

No .ca-prose, todo code inline recebe overflow-wrap: anywhere (packages/ui/src/lib/styles/prose.css, regra .ca-prose :where(:not(pre) > code), comentário "Long identifiers and URLs wrap instead of forcing horizontal scroll on phones"). Em coluna estreita isso quebra o identificador no meio da palavra e parte o chip (borda, fundo e raio) em dois pedaços.

Medido em docs reais (wiApi, @codeatlasdev/ui 4.6.0, viewport 390x844, coluna de texto de 314px; células de tabela de 85 a 158px):

  • disconnect vira disconnec / t; X-Total-Count vira X-Total- / Count; interactive_not_delivered chega a 3 linhas numa coluna de 85px.
  • 220 tokens quebrados em 99 páginas, todos com largura natural menor que a coluna (cabiam inteiros na linha seguinte).
  • A exceção existente (td:first-child code { white-space: nowrap }) só vale para a primeira coluna: code em célula de texto ou em parágrafo continua quebrando.

Reprodução

  1. Página de documentação com .ca-prose, viewport 390px.
  2. <p>O WhatsApp recusou o vínculo. Chame <code>connect</code> de novo ou <code>disconnect</code> ...</p> dentro de coluna estreita (ou uma célula de tabela com 85px).
  3. Inspecionar getClientRects() do code: dois fragmentos em linhas diferentes; getComputedStyle(code).overflowWrap === "anywhere".

Comportamento esperado

Um identificador nunca quebra no meio da palavra, e o chip nunca se parte, a menos que o token seja mais largo que a coluna.

Proposta

  1. Padrão do code inline: white-space: nowrap; overflow-wrap: normal; hyphens: none.
  2. Token longo (o consumidor marca com data-wrap, ou o ui marca acima de N caracteres): display: inline-block; max-width: 100%; white-space: normal; overflow-wrap: break-word. Vira uma caixa atômica: vai inteira para a linha seguinte se não couber no resto da linha e só quebra dentro do próprio chip (nos pontos <wbr> depois de / . _ - : , ? =) quando é mais larga que a coluna.
  3. Medida no teste do ui: nenhum code inline com largura natural <= coluna ocupa mais de uma linha, em 320, 390 e 768px.

Regra geral

Código inline é um token: ele ou cabe inteiro, ou é a única coisa que quebra, e só em pontos de separação. O ui não deve resolver "não rolar na horizontal" quebrando identificadores.

Workaround local: apps/docs/src/app.css (ca-ui-workaround(#N)), teste apps/docs/tests/layout.spec.ts.

主要语言
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 摘要。