prose tables: tabela de definição (identificador + texto) precisa empilhar linhas em coluna estreita, com regra determinística

Ouverte
#1,345 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
35/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Active
Stack technique
typescript
Domaine
design, frontend

Piste de recherche

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.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

area:docs area:theme enhancement

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 com data-label (nome da coluna) e data-prose nas de texto.
  • CSS por @container no wrapper (container-type: inline-size), limiar em token (40rem na wiApi). thead fica só para tecnologia assistiva; o rótulo vem de td::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 code em todas as linhas e no máximo 16 linhas; qualquer outra tabela rola. data-prose quando 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).

Langage dominant
TypeScript
Étoiles
6
Forks
3
Merge moyen
5 h 21 min
PR mergées (30 j)
378

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de codeatlasdev/ui

Toutes les issues de codeatlasdev/ui

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.