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

Abierto
#1,344 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
55/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
TypeScript
Estrellas
6
Forks
3
Merge medio
5 h 21 min
PR fusionados (30 d)
378

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de codeatlasdev/ui

Todos los issues de codeatlasdev/ui

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.