Conteúdo filho dentro de um componente
Um slot é um espaço definido no template de um componente para apresentar o conteúdo filho fornecido na sua utilização. No Astro, o elemento <slot /> recebe o conteúdo filho. Assim, um componente de aviso pode manter sua estrutura e receber uma mensagem diferente em cada uso.
O slot padrão apresenta os filhos sem um nome de slot específico. Para separar regiões, você declara um slot com name e encaminha o conteúdo com o atributo slot de mesmo valor. Essa explicação usa o funcionamento do Astro, pois outros sistemas de componentes podem ter condições próprias.
Um aviso com título e mensagem
O componente didático Aviso.astro reserva uma região para o título e outra para a mensagem:
<aside> <h2><slot name="titulo">Aviso</slot></h2> <slot /></aside>Uma página que importa esse componente pode fornecer os dois conteúdos:
---import Aviso from "../components/Aviso.astro"---
<Aviso> <span slot="titulo">Manutenção programada</span> <p>O atendimento retorna às 14h.</p></Aviso>O Astro coloca o span no slot titulo dentro do h2 e apresenta o parágrafo no slot padrão logo depois do título. Com esse preenchimento, o HTML gerado reúne a estrutura do componente e o conteúdo de exemplo fornecido pela página.
Ausência de conteúdo e fallback
A palavra “Aviso” dentro do slot nomeado é o fallback, ou conteúdo de substituição. Ela aparece quando nenhum slot titulo é fornecido. Passar esse slot vazio não ativa o fallback, por isso você precisa tratar separadamente um título cujo slot foi fornecido vazio.
No Astro, o elemento encaminhado a um slot nomeado deve ser filho direto do componente. No exemplo, o span está diretamente dentro de Aviso. Envolvê-lo em outro elemento muda essa condição e exige revisar como o conteúdo será passado.
Dúvidas frequentes
Perguntas frequentes sobre slot
- Um slot recebe apenas texto?
- No Astro, um slot pode receber conteúdo HTML e componentes como filhos. O componente que contém o slot define onde esse conteúdo será renderizado.
- Qual é a diferença entre um slot e uma prop no Astro?
- Uma prop é recebida como atributo e fica disponível em Astro.props. Um slot recebe conteúdo filho para apresentação na posição definida no template.
- O fallback aparece quando um slot está vazio?
- O fallback aparece quando não há um slot correspondente fornecido. Se um slot for passado vazio, o Astro não usa o fallback como substituto desse conteúdo vazio.
Para continuar
Recursos relacionados
Documentação
Astro: posições de conteúdo com slots
Guia de slots do Astro, com o encaminhamento de conteúdo filho, as regiões nomeadas e as condições de exibição do fallback.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão de desenvolvimento colaborativo para revisar a passagem de conteúdo entre componentes com orientação técnica ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão de componentes criados com agentes inclui conferir onde o conteúdo filho aparece e como o componente trata a ausência desse conteúdo.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.