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

Offen
#1,337 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
48/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
typescript
Bereich
frontend

Rechercherichtung

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.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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

Vorherrschende Sprache
TypeScript
Sterne
6
Forks
3
Ø Merge
5 Std. 21 Min.
Gemergte PRs (30 T.)
378

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus codeatlasdev/ui

Alle Issues in codeatlasdev/ui

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.