DocsShell: o pager fixo cobre ~10% da tela de leitura no celular; precisa de variante inline
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 3/5
- 預估耗時
- 1-2 天
- 新手友好度
- 72/100
- Issue 類型
- 功能
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- typescript
研究方向
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.
由索引模型根據 Issue 內容生成。
描述
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)).
- 主要語言
- TypeScript
- 星號
- 6
- 分支
- 3
- 平均合併
- 5 小時 21 分鐘
- 30 天內合併 PR
- 378
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
codeatlasdev/ui 的其他 Issue
-
難度 2/5 1-3 小時 新手友好度 84/100
codeatlasdev/ui#1340 ·
維護者通常 1 天內回覆
-
area:a11y area:components bug
難度 2/5 1-3 小時 新手友好度 76/100
codeatlasdev/ui#1336 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 77/100
codeatlasdev/ui#1329 ·
維護者通常 1 天內回覆
-
good first issue
難度 2/5 1-3 小時 新手友好度 74/100
codeatlasdev/ui#1292 · 1 則留言 ·
維護者通常 1 天內回覆
-
area:components enhancement good first issue
難度 2/5 1-3 小時 新手友好度 68/100
codeatlasdev/ui#1198 ·
維護者通常 1 天內回覆
相似的 Issue
-
bug frontend
難度 2/5 1-3 小時 新手友好度 85/100
CivicTechWR/accessible-housing-portal#578 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 68/100
nekko-labs/nekko-agent#2998 ·
維護者通常 1 天內回覆
-
難度 1/5 1 小時以內 新手友好度 86/100
sandbox-quantum/switch#2163 ·
維護者通常 1 天內回覆
-
enhancement ux
難度 2/5 1-3 小時 新手友好度 72/100
lolimmlost/aidj#433 ·
維護者通常 1 天內回覆
-
test: ipcShownDialogKeys.test.tsx can fail the unit run with 'window is not defined' after it ends未關閉
難度 2/5 1-3 小時 新手友好度 72/100
維護者通常 1 天內回覆