As props são valores passados a um componente para definir seu conteúdo ou configurar seu comportamento. O componente recebe esses valores pelos atributos usados na chamada. Nos arquivos .astro, eles ficam disponíveis no objeto Astro.props durante a renderização.
Uma página pode reutilizar um cartão de curso com títulos diferentes. O modelo do cartão permanece no mesmo arquivo e cada chamada fornece o texto que deve aparecer naquela instância. O nome da propriedade precisa coincidir com o nome que o componente lê.
Um cartão recebe o título do curso
Neste exemplo didático, o arquivo CartaoCurso.astro extrai a prop titulo e a insere no título do cartão. O texto padrão atende chamadas que omitem essa propriedade.
---const { titulo = 'Curso sem título' } = Astro.props---<h2>{titulo}</h2>Depois de importar o componente, a página pode usar <CartaoCurso titulo="Automação com n8n" /> para produzir um elemento h2 com “Automação com n8n”. O texto padrão aparece quando a chamada omite titulo, inclusive se a página fornecer por engano uma propriedade chamada title. Nesse caso, o nome diferente explica por que o título esperado não aparece no cartão.
Passagem de valores para o navegador
As props de um componente Astro participam da geração do HTML. Elas não criam, por si só, uma atualização interativa após o clique. Esse comportamento precisa de código no navegador.
Quando o Astro envia props a um componente de framework com diretiva client:*, ele precisa convertê-las para um formato adequado à transferência para o navegador. Esse processo se chama serialização e admite os tipos documentados pelo Astro. Uma função usada no servidor, por exemplo, não pode ser enviada como prop executável ao navegador.
Dúvidas frequentes
Perguntas frequentes sobre props
- Uma prop precisa ser texto?
- Os componentes podem receber números e objetos, entre outros tipos. Ao enviar props do Astro para um componente hidratado no navegador, é preciso respeitar os tipos que o Astro consegue serializar.
- Props e slots têm a mesma função no Astro?
- As props fornecem valores pelos atributos do componente e ficam disponíveis em Astro.props. Um slot marca o local do modelo que receberá o conteúdo filho inserido entre as tags do componente.
- O valor padrão substitui qualquer valor vazio?
- Na desestruturação de JavaScript, o padrão é aplicado quando a propriedade está ausente ou contém undefined. Uma string vazia ou null exige tratamento próprio se esses valores também forem inválidos.
Para continuar
Recursos relacionados
Documentação
Astro: propriedades recebidas pelos componentes
Documentação do Astro sobre Astro.props, valores padrão e inserção de conteúdo por slots.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Na sessão de Desenvolvimento Colaborativo da Dev Side Studio, você pode investigar com orientação ao vivo por que um componente recebe ou exibe um valor incorreto.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
No desenvolvimento com agentes, conferir as props permite comparar os valores fornecidos pela página com os valores esperados pelo componente.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.