Pages
Les pages sont des fichiers qui se trouvent dans le sous-répertoire src/pages/
de votre projet Astro. Ils sont responsables de la gestion du routage, du chargement des données et de la mise en page globale de chaque page de votre site Web.
Fichiers de page pris en charge
Titre de la section Fichiers de page pris en chargeAstro prend en charge les types de fichiers suivants dans le répertoire src/pages/
:
.astro
.md
.mdx
(avec l’intégration MDX installée (EN)).html
.js
/.ts
(comme endpoints)
Routage basé sur les fichiers
Titre de la section Routage basé sur les fichiersAstro utilise une stratégie de routage appelée routage basé sur les fichiers. Chaque fichier de votre répertoire src/pages/
devient un point d’accès sur votre site en fonction de son chemin d’accès.
Un seul fichier peut également générer plusieurs pages en utilisant le routage dynamique. Cela vous permet de créer des pages même si votre contenu se trouve en dehors du répertoire spécial /pages/
, par exemple dans une collection de contenu ou un CMS.
📚 En savoir plus sur Le routage dans Astro.
Lien entre les pages
Titre de la section Lien entre les pagesÉcrivez des éléments HTML standard <a>
dans vos pages Astro pour créer des liens vers d’autres pages de votre site. Utilisez un chemin d’URL relatif à la racine de votre domaine comme lien, et non un fichier de chemin relatif.
Par exemple, pour créer un lien https://example.com/authors/sonali/
depuis n’importe quelle autre page de example.com
:
Pages Astro
Titre de la section Pages AstroLes pages Astro utilisent l’extension de fichier .astro
et prennent en charge les mêmes fonctionnalités que les composants Astro.
Une page doit produire un document HTML complet. S’il n’est pas explicitement inclus, Astro ajoutera la déclaration <!DOCTYPE html>
et le contenu <head>
nécessaires à tout composant .astro
situé dans src/pages/
par défaut. Vous pouvez renoncer à ce comportement pour chaque composant en le marquant comme une page partial.
Pour éviter de répéter les mêmes éléments HTML sur chaque page, vous pouvez déplacer les éléments communs <head>
et <body>
dans vos propres composants de mise en page. Vous pouvez utiliser autant, ou aussi peu de composants de mise en page que vous le souhaitez.
📚 En savoir plus sur les composants de mise en page dans Astro.
Pages Markdown/MDX
Titre de la section Pages Markdown/MDXAstro traite également tous les fichiers Markdown (.md
) contenus dans src/pages/
comme des pages de votre site Web final. Si vous avez installé l’intégration MDX (EN), les fichiers MDX (.mdx
) sont traités de la même manière. Ces fichiers sont généralement utilisés pour les pages contenant beaucoup de texte, comme les articles de blog et la documentation.
Les collections de contenu de pages Markdown ou MDX dans src/content/
peuvent être utilisées pour générer des pages dynamiquement.
Les mises en page sont particulièrement utiles pour les fichiers Markdown. Les fichiers Markdown peuvent utiliser la propriété frontmatter spéciale layout
pour spécifier un composant de mise en page qui enveloppera leur contenu Markdown dans un document page complet <html>...</html>
.
📚 En savoir plus sur le Markdown dans Astro.
Pages HTML
Titre de la section Pages HTMLLes fichiers portant l’extension .html
peuvent être placés dans le répertoire src/pages/
et utilisés directement comme pages sur votre site. Notez que certaines fonctionnalités clés d’Astro ne sont pas prises en charge dans les Composants HTML.
Page d’erreur 404 personnalisée
Titre de la section Page d’erreur 404 personnaliséePour une page d’erreur 404 personnalisée, vous pouvez créer un fichier 404.astro
ou 404.md
dans /src/pages
.
Il sera construit en une page 404.html
. La plupart des services de déploiement le trouveront et l’utiliseront.
Page Partielle
Titre de la section Page Partielleastro@3.4.0
Les pages partielles sont destinées à être utilisées en conjonction avec une bibliothèque front-end, telle que htmx ou Unpoly. Vous pouvez également les utiliser si vous êtes à l’aise avec l’écriture d’un JavaScript front-end de bas niveau. C’est pourquoi il s’agit d’une fonctionnalité avancée.
En outre, les pages partielles ne doivent pas être utilisées si le composant contient des styles ou des scripts, car ces éléments seront supprimés de la sortie HTML. Si vous avez besoin de styles délimités, il est préférable d’utiliser des pages régulières, non partielles, ainsi qu’une bibliothèque front-end qui sait comment fusionner le contenu dans l’en-tête.
Les partiels sont des composants de page situés dans src/pages/
qui ne sont pas destinés à être affichés comme des pages complètes.
Comme les composants situés en dehors de ce dossier, ces fichiers n’incluent pas automatiquement la déclaration <!DOCTYPE html>
, ni aucun contenu <head>
tel que les styles et les scripts.
Cependant, parce qu’ils sont situés dans le répertoire spécial src/pages/
, le HTML généré est disponible à une URL correspondant à son chemin de fichier. Cela permet à une bibliothèque de rendu (par exemple htmx, Stimulus, jQuery) d’y accéder sur le client et de charger des sections de HTML dynamiquement sur une page sans rafraîchissement du navigateur ni navigation dans la page.
Les partiels, lorsqu’ils sont associés à une bibliothèque de rendu, constituent une alternative aux îles Astro et aux balises <script>
pour la création de contenu dynamique dans Astro.
Les fichiers de page qui peuvent exporter une valeur (par exemple .astro
, .mdx
) peuvent être marqués comme partiels.
Configurez un fichier dans le répertoire src/pages/
pour être un partiel en ajoutant l’export suivant :
L’export const partial
doit être identifiable statiquement. Il peut avoir la valeur de :
- Le booléen
true
. - Une variable d’environnement utilisant import.meta.env comme
import.meta.env.USE_PARTIALS
.
Utilisation avec une bibliothèque
Titre de la section Utilisation avec une bibliothèqueLes partiels sont utilisés pour mettre à jour dynamiquement une section d’une page en utilisant une bibliothèque telle que htmx.
L’exemple suivant montre un attribut hx-post
défini sur l’URL d’une page partielle. Le contenu de la page partielle sera utilisé pour mettre à jour l’élément HTML ciblé sur cette page.
Le fichier partiel .astro
doit exister dans le chemin d’accès correspondant et inclure une exportation définissant la page comme un fichier partiel :
Voir la documentation htmx pour plus de détails sur l’utilisation de htmx.
Learn