Routage
Astro utilise le routage basé sur les fichiers pour générer vos URLs au moment de la compilation en fonction de la structure des fichiers dans le répertoire src/pages/ de votre projet.
Naviguer entre les pages
Section intitulée « Naviguer entre les pages »Astro utilise des éléments HTML standard <a> pour naviguer entre les routes. Il n’y a pas de composant <Link> spécifique au framework.
<p>En savoir plus <a href="/about/">à propos</a> d'Astro !</p>
<!-- Avec `base: "/docs"` configuré --><p>Apprenez-en plus dans notre section <a href="/docs/reference/">référence</a> !</p>Routes statiques
Section intitulée « Routes statiques »Les composants de page .astro ainsi que les fichiers Markdown et MDX (.md, .mdx) dans le répertoire src/pages/ deviennent automatiquement des pages de votre site web. La route de chaque page correspond à son chemin et à son nom de fichier dans le répertoire src/pages/.
# Exemple : Routes statiquessrc/pages/index.astro -> monsite.com/src/pages/a-propos.astro -> monsite.com/a-propossrc/pages/a-propos/index.astro -> monsite.com/a-propossrc/pages/a-propos/moi.astro -> monsite.com/a-propos/moisrc/pages/articles/1.md -> monsite.com/articles/1Il n’y a pas de « configuration de routage » séparée à maintenir dans un projet Astro ! Lorsque vous ajoutez un fichier au répertoire /src/pages, une nouvelle route est automatiquement créée pour vous. Dans les compilations statiques, vous pouvez personnaliser le format de sortie du fichier en utilisant l’option de configuration build.format.
Routes dynamiques
Section intitulée « Routes dynamiques »Un fichier de page Astro peut spécifier des paramètres de route dynamiques dans son nom de fichier pour générer des pages correspondantes. Par exemple, vous pouvez créer un fichier authors/[author].astro qui génère une page de biographie pour chaque auteur de votre blog. author devient un paramètre accessible depuis l’intérieur de la page.
Dans le mode statique par défaut d’Astro, ces pages sont générées au moment de la compilation, et vous devez donc prédéterminer la liste des auteurs (author) qui obtiendront un fichier correspondant. En mode SSR, une page sera générée sur demande pour toute route correspondante.
Mode statique (SSG)
Section intitulée « Mode statique (SSG) »Parce que toutes les routes doivent être déterminées au moment de la compilation, une route dynamique doit exporter une fonction getStaticPaths() qui renvoie un tableau d’objets avec une propriété params. Chacun de ces objets générera une route correspondante.
[dog].astro définit le paramètre dynamique dog dans son nom de fichier, donc les objets retournés par getStaticPaths() doivent inclure dog dans leurs params. La page peut alors accéder à ce paramètre en utilisant Astro.params.
---export function getStaticPaths() { return [ { params: { dog: "clifford" }}, { params: { dog: "rover" }}, { params: { dog: "spot" }}, ];}
const { dog } = Astro.params;---<div>Bon chien, {dog} !</div>Cela va générer trois pages : /dogs/clifford, /dogs/rover, et /dogs/spot, chacune affichant le nom du chien correspondant.
Le nom du fichier peut inclure plusieurs paramètres, qui doivent tous être inclus dans les objets params de getStaticPaths() :
---export function getStaticPaths() { return [ { params: { lang: "en", version: "v1" }}, { params: { lang: "fr", version: "v2" }}, ];}
const { lang, version } = Astro.params;---Cela va générer /en-v1/info et /fr-v2/info.
Les paramètres peuvent être inclus dans des parties séparées du chemin, ainsi nous pourrions utiliser src/pages/[lang]/[version]/info.astro avec la même fonction getStaticPaths() pour générer /en/v1/info et /fr/v2/info.
Décodage des paramètres (params)
Section intitulée « Décodage des paramètres (params) »Les paramètres (params) renvoyés par la fonction getStaticPaths() ne sont pas décodés. Utilisez decodeURI() lorsque vous devez décoder les valeurs des paramètres.
---export function getStaticPaths() { return [ { params: { slug: decodeURI("%5Bpage%5D") }}, // est décodé en "[page]" ]}---getStaticPaths().
Paramètres du reste
Section intitulée « Paramètres du reste »Si vous avez besoin de plus de flexibilité dans le routage de vos URL, vous pouvez utiliser un paramètre du reste ([...path]) dans votre nom de fichier .astro pour faire correspondre les chemins de fichiers de n’importe quelle profondeur :
---export function getStaticPaths() { return [ { params: { path: "un/deux/trois" }}, { params: { path: "quatre" }}, { params: { path: undefined }} ]}
const { path } = Astro.params;---Cela générera /sequences/un/deux/trois, /sequences/quatre, et /sequences. (Définir le paramètre du reste sur undefined lui permet de correspondre à la page de premier niveau).
Les paramètres du reste peuvent être utilisés avec d’autres paramètres nommés. Par exemple, nous pourrions représenter la visionneuse de fichiers de GitHub avec une route dynamique comme celle-ci :
/[org]/[repo]/tree/[branch]/[...file]Dans cet exemple, une requête pour /withastro/astro/tree/main/docs/public/favicon.svg serait divisée en paramètres nommés suivants :
{ org: "withastro", repo: "astro", branch: "main", file: "docs/public/favicon.svg"}Exemple : Pages dynamiques à plusieurs niveaux
Section intitulée « Exemple : Pages dynamiques à plusieurs niveaux »Ici, nous utilisons un paramètre du reste ([...slug]) et la fonctionnalité props de getStaticPaths() pour générer des pages pour des slugs de différentes profondeurs.
---export function getStaticPaths() { const pages = [ { slug: undefined, title: "Magasin Astro", text: "Bienvenue dans le magasin Astro !", }, { slug: "products", title: "Produits Astro", text: "Nous avons beaucoup de produits pour vous", }, { slug: "products/astro-handbook", title: "L'ultime manuel d'Astro", text: "Si vous voulez apprendre Astro, vous devez lire ce livre.", }, ];
return pages.map(({ slug, title, text }) => { return { params: { slug }, props: { title, text }, }; });}
const { title, text } = Astro.props;---<html> <head> <title>{title}</title> </head> <body> <h1>{title}</h1> <p>{text}</p> </body></html>