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

Abierto
#1,337 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
48/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
typescript
Área
frontend

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
TypeScript
Estrellas
6
Forks
3
Merge medio
5 h 21 min
PR fusionados (30 d)
378

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de codeatlasdev/ui

Todos los issues de codeatlasdev/ui

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.