Que fait Astro ?
Présentation
Astro est un framework web pour créer des sites centrés sur le contenu qui n'envoie aucun JavaScript par défaut. Son architecture d'îles hydrate uniquement les composants interactifs, obtenant d'excellents scores Lighthouse tout en prenant en charge React, Vue, Svelte ou tout autre framework UI là où l'interactivité est nécessaire.
Instructions
- Lors de la création de pages, utilisez le routage basé sur les fichiers dans
src/pages/avec des fichiers.astro,.mdou.mdx, et organisez la structure partagée danssrc/layouts/. - Pour ajouter de l'interactivité, utilisez les directives client sur les composants framework : préférez
client:visibleouclient:idleàclient:loadcar la plupart des composants n'ont pas besoin d'hydratation immédiate. - Pour la gestion de contenu, définissez des Collections de contenu dans
src/content/avec des schémas Zod stricts viadefineCollection(), et interrogez-les avecgetCollection()etgetEntry(). - Lors du choix des modes de rendu, utilisez par défaut le statique (SSG) pour les pages marketing et de contenu, utilisez
output: "server"pour les pages dynamiques, ou utilisez le rendu hybride avecexport const prerender = falsepar page. - Pour l'optimisation des images, utilisez le composant
<Image>deastro:assetspour la conversion automatique de format (WebP/AVIF), le redimensionnement et le chargement différé au lieu des balises<img>brutes. - Pour ajouter des transitions de page, activez les View Transitions avec
<ViewTransitions />pour une navigation de type SPA sans livrer un routeur côté client. - Pour intégrer des frameworks UI, installez l'intégration appropriée (
@astrojs/react,@astrojs/vue,@astrojs/svelte) et utilisez les composants Astro pour le contenu statique, en faisant appel aux composants framework uniquement lorsque l'interactivité est requise.
Exemples
Exemple 1 : Construire un blog avec les Collections de contenu
Demande utilisateur : "Crée un blog Astro avec du contenu Markdown typé"
Actions :
- Définir une Collection de contenu "blog" avec un schéma Zod pour le frontmatter (titre, date, tags, auteur)
- Créer une route dynamique
src/pages/blog/[slug].astroavecgetStaticPaths() - Construire la page d'index du blog en interrogeant
getCollection("blog")avec un tri - Ajouter une mise en page avec des balises SEO, une navigation et les View Transitions
Résultat : Un blog généré statiquement avec du contenu validé, des URL propres et des transitions de page fluides.
Exemple 2 : Ajouter des composants interactifs à un site statique
Demande utilisateur : "Ajoute un composant de recherche React à mon site de documentation Astro"
Actions :
- Installer l'intégration
@astrojs/react - Créer le composant de recherche React avec état et gestion d'événements
- Ajouter le composant à la page avec la directive
client:idle - Passer les données statiques en tant que props depuis le frontmatter de la page Astro
Résultat : Un site de documentation entièrement statique à l'exception de l'île de recherche interactive.
Directives
- Utilisez les composants Astro (
.astro) pour le contenu statique ; n'utilisez React/Vue/Svelte que lorsque l'interactivité est nécessaire. - Privilégiez
client:visibleouclient:idleplutôt queclient:loadpour les directives d'hydratation. - Définissez les Collections de contenu avec des schémas Zod stricts pour détecter les erreurs de contenu au moment de la construction.
- Utilisez
<Image>deastro:assetsplutôt que des balises<img>brutes pour une optimisation automatique. - Gardez les layouts légers avec un
<head>partagé, une navigation et un pied de page ; placez le contenu spécifique à la page dans les pages. - Utilisez le rendu hybride : statique pour les pages marketing, SSR uniquement pour les pages personnalisées ou dynamiques.
- Activez les View Transitions pour une navigation de type SPA sans livrer de routeur.