Accueil › Vue.js › Rendu universel ou génération statique
Rendu universel ou génération statique
Nuxt et le rendu serveuravance
Nuxt sait produire le HTML d'une route à deux moments différents : à la requête, ou au build. Le code est le même, l'infrastructure ne l'est pas.
nuxt build # produit un serveur Nitro dans .output
nuxt generate # prérend les routes, produit des fichiers statiques
nuxt build donne un serveur qui rend la page à chaque visite. Les données
sont fraîches, le contenu peut dépendre de la requête — un cookie, un
en-tête —, et il faut faire tourner ce serveur.
nuxt generate fait le même rendu, mais une seule fois, au build. On obtient
un répertoire de fichiers HTML posable sur n'importe quel hébergement
statique. Les données sont figées à l'instant du build, et rien ne peut
dépendre du visiteur.
Le choix ne se fait pas pour l'application entière. routeRules l'attache à un
motif de route.
export default defineNuxtConfig({
routeRules: {
'/': { prerender: true },
'/blog/**': { prerender: true },
'/admin/**': { ssr: false },
},
})
Une documentation est prérendue, un catalogue dont les prix bougent est rendu à la demande, un espace authentifié n'a aucune raison d'être rendu sur le serveur et devient une application monopage. Le critère tient en une question : ce HTML est-il le même pour tout le monde, et jusqu'à quand ?
Les termes à connaître
- nuxt build
Construit l'application et produit dans
.outputun serveur Nitro autonome, qui rendra les pages à la demande.- nuxt generate
Construit l'application en prérendant les routes, pour obtenir un site de fichiers statiques déployable sans serveur applicatif.
- Prérendu
Le rendu d'une route effectué au moment du build, et non à la requête. Le HTML produit est servi tel quel à tous les visiteurs.
- routeRules
Clé de
nuxt.configqui attache un comportement à un motif de route : prérendu, absence de rendu serveur, en-têtes, redirection, mise en cache.- Rendu hybride
Le fait de choisir le mode route par route dans une même application : une partie prérendue, une partie rendue à la demande, une partie en monopage.
- Explorateur de liens
Le mécanisme qui, au prérendu, part d'une route et suit les liens internes du HTML produit pour découvrir les routes suivantes.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.