Formations — 1 037 leçons en français

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 .output un 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.config qui 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.

Lire l'explication détaillée et faire le quiz →

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.