DocsShell: o pager fixo cobre ~10% da tela de leitura no celular; precisa de variante inline
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ó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 72/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- typescript
- Lĩnh vực
- accessibility, frontend
Hướng nghiên cứu
Start in DocsShell.svelte and read the mobile @media (max-width: 899.98px) rules for .ca-docs-pager and the main padding. Trace how pagerPlacement would be exposed and applied, then check the layout at 390px: inline mode should place the pager after the page content without a fixed overlay or extra bottom padding; bar mode should remain opt-in. The issue also calls for a layout test verifying text never intersects the pager while scrolling.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problema
Abaixo de 900px o DocsShell fixa o pager (Anterior / Próxima) como barra sobre a parte inferior da tela (DocsShell.svelte, @media (max-width: 899.98px): .ca-docs-pager { position: fixed; inset: auto 0 0 0 }). Em página de leitura isso significa uma faixa permanente sobre o texto que está sendo lido.
Medido (wiApi, @codeatlasdev/ui 4.6.0, iPhone 390x844):
- A barra cobre 52px +
--ca-safe-bottom(34px no iPhone com indicador de início) = até 86px de 844px (10% da tela) o tempo todo. - O fundo é
--ca-chrome-bga 72% (claro) / 85% (escuro): tabelas e blocos de código passam por baixo e aparecem como texto fantasma ("Campo / Tipo / Descrição" legível atrás de "Anterior / Próxima" na foto do dono do produto). - O espaço reservado no fim da página existe (
padding-bottomdespace-12 + touch-target + safe-bottom), então o último bloco não fica coberto no fim da rolagem; o problema é durante a leitura.
Comportamento esperado
Navegação entre páginas de documentação não toma área de leitura. O pager é o último bloco da página, como já é a partir de 900px.
Proposta
- Prop
pagercom variante (pagerPlacement="inline" | "bar"), padrãoinlineparaDocsShellde leitura;barfica opt-in para quem quiser a barra nativa. - Em
inline, semposition: fixed, sembackdrop-filter, sempadding-bottomextra nomain. - Teste de layout: em 390px, nenhum elemento de texto interseciona o pager em nenhuma posição de rolagem.
Regra geral
Um elemento fixo sobre conteúdo de leitura só existe se reservar sua área o tempo todo (como header sticky que empurra o conteúdo); chrome que sobrepõe texto não é aceitável para navegação secundária.
Workaround local: apps/docs/src/app.css (ca-ui-workaround(#N)).
- 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