prose tables: tabela de definição (identificador + texto) precisa empilhar linhas em coluna estreita, com regra determinística
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 35/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
Start with apps/docs/src/lib/markdown/rehype-docs.js and apps/docs/src/app.css, then review issue #1311 for the existing card behavior. Define and implement the deterministic Markdown table reflow rules, container width threshold, and accessible stacked row labels; verify the narrow viewport behavior against the stated 360–430px test criterion and ensure other tables retain scroll guidance.
由索引模型根据 Issue 内容生成。
描述
Problema
Tabela de definição (primeira coluna é um identificador code, 2 a 4 colunas, poucas linhas) é ilegível no celular de qualquer jeito que o ui a renderiza hoje: ou as colunas de texto são espremidas (uma ou duas palavras por linha), ou a tabela rola e a última coluna fica cortada.
Caso medido (wiApi, 390px, coluna de 314px), tabela reason | Quando | O que fazer: a primeira coluna toma a largura dos chips, a coluna do meio fica com ~110px ("O / WhatsApp / recusou o / vínculo") e a terceira some na borda. Na auditoria das 104 páginas das docs, 106 células de texto ficaram abaixo de 16ch (80 a 85px) em tabelas de 4 colunas no celular.
O ui só oferece rolagem (.ca-table-wrap) e, para componentes, .ca-table-root--cards (#1311). Nada cobre tabelas Markdown.
Comportamento esperado
Uma tabela de definição, abaixo de um limiar de largura do próprio contêiner, vira linhas empilhadas: o identificador é o título da linha e cada célula aparece com o nome da coluna acima. As demais tabelas rolam com dica (ver issue da dica de rolagem).
Proposta
- Contrato de marcação:
.ca-table-wrap[data-reflow](ou.ca-table-wrap--stack), células comdata-label(nome da coluna) edata-prosenas de texto. - CSS por
@containerno wrapper (container-type: inline-size), limiar em token (40rem na wiApi).theadfica só para tecnologia assistiva; o rótulo vem detd::before { content: attr(data-label) }. - Regra de decisão determinística, que um plugin rehype/remark do ui poderia aplicar: reflow se 2 a 4 colunas, primeira coluna só com
codeem todas as linhas e no máximo 16 linhas; qualquer outra tabela rola.data-prosequando a célula tem 3 palavras ou mais e não é sócode. - Alinhar com #1311 (
ca-table-root--cards): mesma semântica, um nome só. - Teste: nenhuma célula de texto de tabela Markdown fica abaixo de 16ch em 360 a 430px.
Regra geral
Texto em tabela nunca é espremido abaixo de uma medida legível: a tabela cabe, reorganiza as linhas ou rola com sinal.
Implementação de referência: apps/docs/src/lib/markdown/rehype-docs.js e apps/docs/src/app.css (wiApi).
- 主要语言
- TypeScript
- 星标
- 6
- 派生
- 3
- 平均合并
- 5 小时 21 分钟
- 30 天内合并 PR
- 378
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
codeatlasdev/ui 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 84/100
codeatlasdev/ui#1340 ·
维护者通常 1 天内回复
-
area:a11y area:components bug
难度 2/5 1-3 小时 新手友好度 76/100
codeatlasdev/ui#1336 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 77/100
codeatlasdev/ui#1329 ·
维护者通常 1 天内回复
-
good first issue
难度 2/5 1-3 小时 新手友好度 74/100
codeatlasdev/ui#1292 · 1 条评论 ·
维护者通常 1 天内回复
-
area:components enhancement good first issue
难度 2/5 1-3 小时 新手友好度 68/100
codeatlasdev/ui#1198 ·
维护者通常 1 天内回复
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 86/100
sandbox-quantum/switch#2163 ·
维护者通常 1 天内回复
-
automated issue report
难度 1/5 1 小时以内 新手友好度 78/100
维护者通常 1 天内回复
-
area/dashboard kind/bug QA/dev-automation
难度 1/5 1 小时以内 新手友好度 75/100
维护者通常 1 天内回复
-
bug pydanty:is-working
难度 2/5 1-3 小时 新手友好度 82/100
pydantic/pydantic-ai#13939 ·
维护者通常 1 天内回复
-
self-host
难度 2/5 1-3 小时 新手友好度 70/100
funmusicplace/mirlo#2625 ·
维护者通常 1 天内回复