Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é Content Collections?

    As Content Collections reúnem entradas para consulta e validação no Astro. Entenda como o carregamento dos documentos se liga aos filtros e às páginas.

    Também chamado de: coleções de conteúdo do Astro

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    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

    Documentos reunidos para consulta

    As Content Collections são um recurso do Astro para carregar documentos relacionados e consultá-los nas páginas do site. Cada documento carregado constitui uma entrada da coleção. Uma coleção de artigos pode reunir arquivos de Markdown, ler o título do frontmatter e manter o corpo de cada texto disponível para apresentação.

    O loader é a parte que busca as entradas na origem configurada. Com o loader glob, essa origem é um diretório de arquivos selecionados por um padrão de caminho. O schema descreve a estrutura dos campos, como a exigência de um título em texto, e permite validar as entradas e gerar seus tipos em TypeScript. Ele é opcional no Astro e verifica a estrutura do conteúdo, sem confirmar a veracidade do artigo.

    Um filtro para os artigos publicados

    Em um exemplo de coleção chamada artigos, cada documento declara o campo booleano rascunho. A consulta getCollection('artigos', ({ data }) => data.rascunho === false) devolve somente as entradas cujo campo contém false. Um arquivo com rascunho: true continua na coleção, mas fica fora do resultado dessa consulta.

    Você pode usar o resultado para montar uma lista de títulos. Para apresentar o artigo completo, a página precisa também renderizar o corpo da entrada. Consultar uma coleção e criar os endereços públicos são tarefas distintas: o Astro não cria uma rota para cada documento apenas porque ele pertence à coleção.

    Por que um artigo pode faltar na listagem

    Uma entrada ausente pode ter ficado fora do padrão de arquivos do loader ou ter sido excluída pelo filtro. Compare o caminho do documento com a origem configurada e confira o valor de rascunho usado na consulta. Alterar o filtro sem conferir esse campo pode incluir textos que ainda deveriam permanecer fora da listagem.

    O mesmo cuidado vale para a página individual. Excluir o rascunho da lista não restringe o acesso a uma rota criada por outra consulta. O filtro precisa acompanhar a seleção das entradas usadas para gerar ou atender esses endereços.

    A ligação entre a consulta e a página pode ser revisada no Desenvolvimento Colaborativo da Dev Side Studio, uma sessão prática com você no editor e orientação técnica ao vivo.

    Dúvidas frequentes

    Perguntas frequentes sobre Content Collections

    Uma coleção cria uma página para cada entrada?
    Não. A coleção disponibiliza as entradas para consulta. O projeto precisa definir as rotas e a apresentação do conteúdo, incluindo a seleção dos artigos publicados.
    O Astro exige um schema para a coleção?
    O schema é opcional no Astro. Quando definido, ele valida a estrutura dos campos das entradas e fornece tipos em TypeScript para as consultas.
    Um campo de rascunho impede a publicação?
    O campo só descreve o estado da entrada. A consulta precisa usar esse valor para excluir os rascunhos tanto da listagem quanto da seleção que alimenta as páginas individuais.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    A consulta a coleções permite usar documentos estruturados na construção das páginas de um sistema web.

    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