O roteamento por arquivo usa os nomes e a organização dos arquivos para definir os endereços atendidos pelo site. No Astro, os arquivos de página ficam em src/pages. Uma página src/pages/sobre.astro, por exemplo, corresponde ao caminho /sobre.
As pastas acrescentam segmentos ao endereço. O arquivo src/pages/empresa/contato.astro corresponde a /empresa/contato. Já o nome index.astro representa o endereço da própria pasta, por isso src/pages/empresa/index.astro corresponde a /empresa.
Um arquivo para vários cursos
Uma rota dinâmica usa um nome entre colchetes para receber parte do endereço. Neste exemplo didático, src/pages/cursos/[slug].astro pode representar páginas de cursos diferentes. Na geração estática, a função abaixo enumera os caminhos que serão produzidos.
export function getStaticPaths() { return [ { params: { slug: 'automacao' } }, { params: { slug: 'desenvolvimento' } }, ]}O resultado é a geração de /cursos/automacao e /cursos/desenvolvimento. Dentro da página, Astro.params.slug fornece o segmento correspondente. A declaração de [slug] não cria páginas estáticas para qualquer nome digitado no navegador. Cada caminho precisa constar no retorno de getStaticPaths().
Endereço e forma de renderização
Na renderização sob demanda, o servidor recebe o endereço e monta a página compatível com o parâmetro recebido. Essa modalidade exige a configuração e o adaptador adequados à hospedagem. O código da página ainda precisa verificar se o curso solicitado existe.
Os exemplos mostram os caminhos sem um prefixo de publicação. A configuração base pode acrescentar esse prefixo e a política de barra final também afeta a URL utilizada. Você precisa conferir esses ajustes ao comparar o arquivo com o endereço aberto no navegador.
Dúvidas frequentes
Perguntas frequentes sobre roteamento por arquivo
- Um componente em src/components cria uma página?
- Esse diretório guarda componentes reutilizáveis e não cria rotas automaticamente. No Astro, as páginas seguem as convenções de nomes e formatos aceitos em src/pages.
- Uma rota dinâmica é renderizada a cada acesso?
- Ela também pode ser pré-renderizada. Nesse caso, getStaticPaths enumera os caminhos durante o build. A renderização sob demanda atende a rota no servidor quando chega uma requisição.
- Como representar o endereço /sobre?
- Você pode usar src/pages/sobre.astro ou src/pages/sobre/index.astro. As duas formas representam o mesmo caminho. Escolha uma delas para evitar duas definições concorrentes.
Para continuar
Recursos relacionados
Documentação
Astro: arquivos, páginas e parâmetros de rota
Documentação do Astro sobre correspondência entre arquivos e URLs, parâmetros dinâmicos e getStaticPaths.
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 uma URL que não corresponde à página esperada.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
No desenvolvimento com agentes, conferir os arquivos de rota permite verificar quais endereços a aplicação deve atender.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.