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
Documentação
Astro: carregamento de conteúdo
Documenta as opções dos loaders, incluindo a seleção de arquivos pelo glob e a origem da pesquisa.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.