Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é props?

    As props fornecem valores para um componente definir seu conteúdo ou configurar o comportamento. No Astro, os componentes .astro as recebem em Astro.props.

    Também chamado de: propriedades de componente

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano