PageShell/AppShellLayout: avisos acima da página não entram na coluna do PageShell (título, aviso e corpo em eixos diferentes)

Aperta
#1,337 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
48/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
frontend

Direzione di ricerca

Start with PageShell.svelte and AppShellLayout.svelte to trace how the page column and layout children are rendered, then review the related issues #1044, #1054, and #1331 for context. The issue also points to apps/web/src/app.css and apps/web/tests/page-column.spec.ts for the current workaround and its expected alignment. Done means banners, titles, descriptions, and body content share the intended column across page widths, with the proposed width behaviors clarified.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area:components bug

Versão: @codeatlasdev/ui 4.6.0 (instalada) e main (27621338, 152 commits à frente). Componentes: PageShell, AppShellLayout. Painel de produto: codeatlasdev/wi (apps/web).

O que acontece

Dentro do AppShellLayout, o PageShell desenha a própria coluna centralizada (max-width, margin: 0 auto, gutter) dentro da região de conteúdo, e nada fora dele consegue entrar nessa coluna. Qualquer faixa que o layout renderiza acima da página (aviso global, banner de plano, estado offline) é irmã do .ca-page-shell, ocupa a região inteira e começa em outro eixo que o título.

Medido no wi, desktop 1440x900, rail + painel abertos (região de conteúdo começa em x=252), página Chats > Chamadas, com o aviso vermelho "A sessão Marketing foi desvinculada do WhatsApp" acima da página:

Elemento left width
aviso (Alert, com padding: 12px 16px 0 do app) 268 1156
.ca-page-shell (com maxWidth="720px") 486 720
h1 "Chamadas" e descrição 534 624
estado vazio 534 624

Ou seja: o aviso começa 266px antes do título, e o estado vazio fica em um terceiro eixo. Nas páginas sem maxWidth (Dashboard, Webhooks…) a diferença é 32px (aviso em 268, título em 300: o gutter --ca-page-px de 48px que só o PageShell aplica). No celular (393px) os dois coincidem em 16px por acaso (o gutter --ca-page-px-sm é 16px), então o defeito só aparece a partir de 600px.

Dois padrões do próprio PageShell agravam:

  • maxWidth="720px" (ou --ps-max) recentraliza a coluna inteira, título incluso: cada página com maxWidth diferente tem o título num x diferente (Chamadas 534, Nova conversa 594, Mensagem avançada 354, Dashboard 300 no mesmo viewport). Trocar de rota faz o título "andar".
  • width="reading" centraliza só o corpo (justify-content: center no grid), mas o cabeçalho continua na borda esquerda da coluna: título na borda esquerda da coluna, corpo deslocado para o centro.

Causa

  • PageShell.svelte (.ca-page-shell): max-width: var(--ps-max, var(--ca-page-max, …)); margin: 0 auto; padding: var(--ca-page-pt) var(--ca-page-px) … e @media (max-width: 599.98px) com --ca-page-px-sm. A geometria da coluna existe só nessa regra; não há classe, token composto nem slot para quem renderiza ao lado.
  • AppShellLayout.svelte: .ca-shell__content é a região; o children (aviso + página) caem direto nela. Não há banner/above snippet que o shell envolva na mesma coluna.

Esperado

Título, descrição, avisos globais e corpo compartilham uma coluna e a mesma borda esquerda, em qualquer página e largura, sem o app reimplementar a geometria do PageShell.

Proposta de API

  1. AppShellLayout: snippet banner (ou aboveContent) renderizado dentro da região de rolagem, com a mesma coluna do PageShell (mesmos max-width/gutter), rolando com a página.
  2. Exportar a coluna como utilitário (.ca-page-column, com --ca-page-max/--ca-page-px) usado pelo PageShell e disponível para o app.
  3. PageShell: contentMaxWidth (limita só o corpo, alinhado à esquerda sob o título) e documentar maxWidth como "largura da coluna inteira". width="reading" deveria alinhar o corpo à esquerda da coluna, como o título, ou centralizar também o cabeçalho.

Reprodução

<AppShellLayout {modules} pathname={page.url.pathname}>
  <div class="aviso"><Alert severity="error" title="Aviso global">…</Alert></div>
  <PageShell title="Chamadas" description="…" maxWidth="720px">…</PageShell>
</AppShellLayout>

Em 1440x900: getBoundingClientRect().left de .aviso > * ≠ de .ca-page-shell__meta (268 vs 534).

Workaround no wi

apps/web/src/app.css (.wi-page-column, ca-ui-workaround(#1337)): o layout passa a mesma geometria ao aviso; as páginas deixaram de usar maxWidth/width="reading" e limitam só o corpo. Teste: apps/web/tests/page-column.spec.ts.

Relacionadas

#1044 (cabeçalho compacto do PageShell), #1054, #1331 (acabamento desktop).

Lingua principale
TypeScript
Stelle
6
Fork
3
Merge medio
5h 21m
PR unite (30g)
378

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di codeatlasdev/ui

Tutte le issue di codeatlasdev/ui

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.