Layouts
Layouts são componentes Astro usados para fornecer uma estrutura de UI reutilizável, como um template de página.
Convencionalmente, usamos o termo “layout” para componentes Astro que fornecem elementos comuns de UI compartilhados entre páginas, como cabeçalhos, barras de navegação e rodapés. Um componente de layout Astro típico fornece às páginas Astro, Markdown ou MDX:
- uma estrutura de página (tags
<html>,<head>e<body>) - um
<slot />para especificar onde o conteúdo individual da página deve ser inserido.
Porém, não há nada de especial em componentes de layout! Eles podem receber props e importar e usar outros componentes como qualquer outro componente Astro. Eles podem incluir componentes de frameworks de UI (EN) e scripts no lado do cliente (EN). Eles nem precisam fornecer uma estrutura de página completa e podem ser usados como templates parciais de UI.
No entanto, se um componente de layout contiver uma estrutura de página, seu elemento <html> deverá ser o pai de todos os outros elementos do componente.
Componentes de layout são normalmente colocados em um diretório src/layouts no seu projeto para organização, mas isso não é obrigatório; você pode colocá-los onde preferir. Você pode até manter os componentes de layout junto às suas páginas ao prefixar os nomes dos layouts com _ (EN).
Exemplo de layout
Seção intitulada “Exemplo de layout”---import HeadBase from '../components/HeadBase.astro';import Rodape from '../components/Rodape.astro';const { titulo } = Astro.props;---<html lang="pt-BR"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <HeadBase titulo={titulo}/> </head> <body> <nav> <a href="#">Início</a> <a href="#">Postagens</a> <a href="#">Contato</a> </nav> <h1>{titulo}</h1> <article> <slot /> <!-- seu conteúdo é injetado aqui --> </article> <Rodape /> </body> <style> h1 { font-size: 2rem; } </style></html>