Ir para o conteúdo
Promovaweb

Páginas, layouts e componentes

Revisado em

Páginas definem rotas, layouts compartilham a estrutura visual e componentes agrupam trechos reutilizáveis de interface. Um layout também é um componente Astro.

Função de cada arquivo

Tipo Caminho convencional Função
Página src/pages/sobre.astro Define a rota /sobre/
Layout src/layouts/Base.astro Compartilha a estrutura entre páginas
Componente src/components/Cabecalho.astro Reutiliza um trecho de interface

O nome layouts é uma convenção de organização. O guia de layouts descreve componentes com a estrutura HTML completa ou apenas parte dela.

Formatos em src/pages

Extensão Tratamento pelo Astro
.astro Página com a sintaxe de componentes Astro
.md Página escrita em Markdown
.mdx Página MDX, com a integração MDX instalada
.html Página HTML
.js ou .ts Endpoint

Os formatos de página usam o caminho do arquivo para definir o endereço. Um arquivo de rota dinâmica pode gerar várias páginas.

Anatomia do componente Astro

Sintaxe Função
Cercas --- Delimitam o script do componente
import Importa componentes ou outros módulos no script
Astro.props Acessa as propriedades recebidas
interface Props Declara os tipos das propriedades para a verificação TypeScript
{titulo} Insere uma expressão no template
<slot /> Marca a posição do conteúdo filho

O script entre as cercas roda no build ou na renderização sob demanda. Esse script não é enviado ao navegador, conforme a documentação de componentes.

Layout com props e slot

O arquivo src/layouts/Base.astro recebe o título por prop. O conteúdo entre as tags do layout ocupa o <slot />.

---
interface Props {
titulo: string
}
const { titulo } = Astro.props
---
<html lang="pt-BR">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width" />
<title>{titulo}</title>
</head>
<body>
<main><slot /></main>
</body>
</html>

Uso numa página

Trecho de src/pages/sobre.astro Efeito
import Base from '../layouts/Base.astro' Importa o layout a partir da pasta de páginas
titulo="Sobre" Fornece a prop usada no título da aba
Conteúdo dentro de <Base> Preenche o slot padrão do layout
---
import Base from '../layouts/Base.astro'
---
<Base titulo="Sobre">
<h1>Sobre</h1>
<p>Informações sobre o site.</p>
</Base>

Sem o <slot />, o conteúdo filho não aparece no HTML do layout. Props transportam valores, como o título, enquanto slots recebem trechos de conteúdo.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.