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

Đang mở
#1,348 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
design, frontend

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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).

Ngôn ngữ chính
TypeScript
Star
6
Fork
3
Merge trung bình
5 giờ 21 phút
Pull request đã merge (30 ngày)
378

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của codeatlasdev/ui

Tất cả issue của codeatlasdev/ui

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.