Endereços com uma parte variável
Uma rota dinâmica é uma definição de caminho que usa parâmetros para atender vários endereços. Em uma página de artigos, o parâmetro pode identificar qual texto deve ser apresentado. Você mantém uma definição de página e usa o valor recebido no caminho para selecionar o artigo.
No Astro, o arquivo src/pages/artigos/[slug].astro define uma rota desse tipo. O nome entre colchetes declara a parte variável: o acesso a /artigos/dns/ corresponde ao valor dns de slug. Os colchetes pertencem ao nome do arquivo, não ao endereço que você abre no navegador.
Geração dos caminhos no Astro
Uma rota dinâmica pode produzir páginas estáticas. Nesse caso, a função getStaticPaths() informa quais valores o Astro deve usar durante o build. Em um exemplo com os valores dns e cache, a mesma página gera os endereços /artigos/dns/ e /artigos/cache/. Um novo artigo exige que seu caminho seja incluído na geração e publicado.
Na renderização sob demanda, o Astro recebe o valor por Astro.params.slug durante o acesso. A página usa esse valor para consultar o artigo e montar a resposta. Esse modo exige um adapter compatível com o ambiente de execução e não usa getStaticPaths() para enumerar os endereços.
Um caminho válido pode apontar para um artigo ausente
O endereço /artigos/inexistente/ pode corresponder ao formato da rota sob demanda mesmo sem haver um artigo com esse identificador. A aplicação precisa conferir o resultado da consulta e responder com o status HTTP 404 quando o conteúdo não existir. Exibir uma mensagem de ausência com status 200 informa sucesso ao navegador e aos mecanismos de busca.
Você pode testar um identificador ausente e observar tanto a mensagem quanto o status da resposta. Na versão estática, confira também se o caminho estava entre os gerados. Uma rota parametrizada não cria o registro consultado nem define por si só quais artigos podem ser publicados.
A consulta do artigo pela rota pode ser investigada no Desenvolvimento Colaborativo da Dev Side Studio, com você operando o editor durante a orientação técnica ao vivo.
Dúvidas frequentes
Perguntas frequentes sobre rota dinâmica
- Uma rota dinâmica exige renderização no servidor a cada acesso?
- Não. No Astro, uma rota dinâmica pode gerar páginas estáticas durante o build. A configuração de renderização define se o HTML será produzido previamente ou sob demanda.
- O parâmetro recebido confirma a existência do artigo?
- Não. O endereço pode corresponder ao formato da rota sem haver um artigo com aquele identificador. A aplicação precisa consultar o conteúdo e definir a resposta para a ausência.
- Para que serve getStaticPaths no Astro?
- A função enumera os caminhos de uma rota dinâmica que serão gerados no build. Nas rotas renderizadas sob demanda, o valor chega por Astro.params e getStaticPaths não deve ser usado.
Para continuar
Recursos relacionados
Documentação
Astro: parâmetros e geração de rotas
Explica os nomes entre colchetes e o uso dos parâmetros na geração estática e na renderização sob demanda.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
As rotas parametrizadas permitem apresentar registros de um sistema usando uma definição de página compartilhada.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.