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

Aberta
#1,337 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
48/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
typescript
Domínio
frontend

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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

Linguagem predominante
TypeScript
Estrelas
6
Forks
3
Merge médio
5h 21min
PRs com merge (30d)
378

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de codeatlasdev/ui

Todas as issues de codeatlasdev/ui

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.