prose tables: tabela que rola no celular não mostra sinal (sombra a 14% some no escuro e fica sob o cabeçalho) e a região não tem nome

未關閉
#1,344 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

還沒有人認領這個 Issue。

評估

難度
4/5
預估耗時
3-5 天
新手友好度
55/100
Issue 類型
缺陷
描述清晰度
描述清楚
活躍度
活躍
技術堆疊
typescript

研究方向

Start with the .ca-table-wrap scroll affordance in prose.css and the local workaround in apps/docs/src/lib/table-scroll.ts; check apps/docs/tests/layout.spec.ts for existing table coverage. Reproduce the issue in light and dark themes, then implement and test a visible indication of scroll direction and an accessible name for the focusable region. Done when the tests confirm the indicator appears in both themes and the region is named.

由索引模型根據 Issue 內容生成。

描述

area:docs area:theme bug

Problema

Tabela que rola na horizontal no celular não mostra nenhum sinal de que continua. Em .ca-table-wrap (prose.css, "Scroll affordance") a dica é um sombreamento via background com linear-gradient(to right, oklch(0 0 0 / 0.14), transparent) (preto a 14%) mais cobertura local com --ca-surface-base.

Causas medidas (@codeatlasdev/ui 4.6.0, wiApi, 390px):

  1. Invisível no tema escuro: preto a 14% sobre --ca-surface-base (oklch 0.16) muda cerca de 0,02 de luminosidade (oklch). Nenhum sinal visível; foi como o dono do produto viu a terceira coluna cortada em "Chame connec…" sem saber que rolava.
  2. Escondida atrás do cabeçalho: o th tem background: var(--ca-surface-raised) opaco e pinta acima do fundo do wrapper, então a dica nunca aparece na linha do cabeçalho.
  3. Sem nome acessível: o wrapper tem tabindex="0", mas nada define role="region" nem aria-label; leitores de tela anunciam um grupo sem nome (no app consumidor: aria-label="Tabela" repetido, 51 páginas com mais de uma tabela com o mesmo nome).

Nas docs da wiApi, 177 tabelas em 99 páginas rolam no celular (auditoria em apps/docs/tests/layout.spec.ts).

Comportamento esperado

Enquanto houver colunas escondidas num lado, esse lado mostra o corte de forma perceptível nos dois temas, sobre cabeçalho e corpo, e a região tem nome.

Proposta

  • Estado em CSS/JS mínimo: data-scroll="none|start|middle|end" no wrapper (ResizeObserver + scroll), ou animation-timeline: scroll(x) onde houver suporte.
  • Dica com tokens do tema: mask-image com degradê nas bordas que têm mais conteúdo (funciona em claro/escuro e sobre o cabeçalho) e uma seta (‹ ›) sobre a borda, pointer-events: none, prefers-reduced-motion respeitado. Sem preto literal.
  • Se o wrapper for focalizável, exigir aria-label (prop/atributo documentado) e role="region".
  • Teste: tabela mais larga que a coluna tem data-scroll diferente de none e a seta com opacidade 1, nos dois temas.

Regra geral

Todo contêiner que rola mostra, por tokens e nos dois temas, para que lado há mais conteúdo, e tem nome acessível se for focalizável.

Workaround local: apps/docs/src/app.css (ca-ui-workaround(#N)), apps/docs/src/lib/table-scroll.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 摘要。