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
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
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ả
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:
- 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.
- 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 oinlinepassar 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-topdomain. 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) eedge-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
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của codeatlasdev/ui
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
codeatlasdev/ui#1340 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area:a11y area:components bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
codeatlasdev/ui#1336 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
codeatlasdev/ui#1329 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
codeatlasdev/ui#1292 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area:components enhancement good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
codeatlasdev/ui#1198 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của codeatlasdev/ui
Issue tương tự
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
sandbox-quantum/switch#2163 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
automated issue report
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area/dashboard kind/bug QA/dev-automation
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug pydanty:is-working
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
pydantic/pydantic-ai#13939 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
self-host
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
funmusicplace/mirlo#2625 ·
Maintainer thường phản hồi trong vòng 1 ngày