Páginas, layouts e componentes
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.
