DocsShell no celular: o índice 'Nesta página' é um cartão solto entre dois vazios (título a 25% da tela) e não compartilha a borda do conteúdo

オープン
#1,348 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
48/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript
領域
design, frontend

調査の方向性

Read the TableOfContents inline variant, the .ca-docs-main and .ca-toc--inline styles, and auditLayout from #1290. The issue describes the desired docked mobile index, shared content inset, aligned desktop column tops, and layout checks; compare these with the workaround in apps/docs/src/app.css and tests in apps/docs/tests/layout.spec.ts. Done when the library meets the stated layout measurements and the top-stack, edge-mismatch, and column-tops checks pass.

索引モデルが issue の本文から書いたものです。

説明

area:components area:docs bug

Problema (medido em produção, @codeatlasdev/ui 4.6.0, docs do wi)

O dono abriu uma página das docs no celular e apontou o topo: muito espaço vazio antes do título. Medido em docs.wi.api.br/guides/conectar-ia-mcp/ a 390×844, 360×640 e 820×1180 (os três dão os mesmos números):

Faixa y De quem
Cabeçalho 0 a 53 lib
Vazio 53 a 85 (32px) lib: .ca-docs-main padding-top (--ca-docs-main-pt, padrão --ca-space-8)
Cartão "Nesta página" 85 a 131 lib: TableOfContents variant="inline"
Vazio 131 a 155 (24px) lib: .ca-toc--inline { margin: 0 0 var(--ca-space-6) }
Vazio 155 a 185 (30px) app: padding-top do artigo
Título (h1) 209

O título começa a 25% de uma tela de 844px e a 33% de uma de 640px. Só com a lib (sem os 30px do app) o conteúdo já começa 102px abaixo do cabeçalho: 32 + 46 + 24.

Dois defeitos de composição além da altura:

  1. O índice é um cartão solto. Ele flutua entre dois vazios, com borda, raio e fundo próprios, e parece um elemento a mais para ler antes do título.
  2. Duas bordas esquerdas. O cartão vai de x=19 a 371 (gutter do main); qualquer app que centralize o artigo numa coluna com respiro (o wi usa mais 18,75px) fica com o texto em x=38. O índice e o texto nunca compartilham a borda, e a lib não dá como alinhar.

No desktop (1440×900) o primeiro texto da barra lateral e o do trilho "Nesta página" começam em y=83, e o conteúdo do main em y=89: 6px de diferença entre colunas vizinhas, só com os valores da lib.

Proposta

  • TableOfContents variant="docked" (ou o inline passar a ser assim abaixo de 900px): uma barra de largura cheia colada sob o cabeçalho, sem cartão, sem raio e sem margem externa, com a mesma superfície do cabeçalho e um fio inferior, 44px de altura, texto na borda do conteúdo. Rola com a página. Aberta, a lista desce de borda a borda.
  • O espaço entre o índice e o conteúdo tem um dono: o padding-top do main. O índice não soma margem própria.
  • Um token de borda do conteúdo (--ca-docs-content-inset) que o cabeçalho, o índice e o artigo leem, para as três bordas coincidirem quando o app estreita a coluna.
  • Primeira linha das três colunas do desktop na mesma altura (hoje 83 / 89 / 83).
  • Detectores no auditLayout (#1290): top-stack (título a no máximo 100px do cabeçalho no celular) e edge-mismatch (bordas esquerdas do índice, título e primeiro parágrafo dentro de 1px).

Workaround no wi

ca-ui-workaround desta issue em apps/docs/src/app.css: o índice vira barra colada sob o cabeçalho e o artigo perde o padding-top próprio. Teste: apps/docs/tests/layout.spec.ts (top-stack, edge-mismatch, column-tops).

Relacionados

#1347 (composição por tela e espaço com função), #1346 (pager fixo), #738 (alvo de toque do índice inline), #1084 (vazio sem função).

主要言語
TypeScript
スター
6
フォーク
3
平均マージ
5時間 21分
マージ済み PR(30日)
378

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

codeatlasdev/ui のほかの issue

codeatlasdev/ui の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。