Accueil › Vue.js › Le build et le découpage du paquet
Le build et le découpage du paquet
Mise en productionavance
vite build produit un dossier dist/ : un index.html, et des fichiers
JavaScript et CSS dont le nom contient une empreinte dérivée du contenu,
du type index-Ba7x9Kd2.js. Cette empreinte est le pivot de toute la stratégie
de cache : le nom change quand le contenu change, donc on peut garder le
fichier très longtemps.
Par défaut, tout votre code applicatif finit dans un seul fichier. Un visiteur
qui ouvre la page d'accueil télécharge aussi l'écran d'administration, l'éditeur
de texte riche et la bibliothèque de graphiques. Le levier est l'import()
dynamique.
// router/index.js
const routes = [
{ path: '/', component: () => import('../pages/Accueil.vue') },
{ path: '/admin', component: () => import('../pages/Admin.vue') }
]
Rollup, qui fait le build de Vite, voit ces import() et place chaque page
dans un fichier distinct, chargé au moment de la navigation. Le même geste
existe hors routage avec defineAsyncComponent.
import { defineAsyncComponent } from 'vue'
const EditeurRiche = defineAsyncComponent(
() => import('./EditeurRiche.vue')
)
La fonction est appelée, pas évaluée tout de suite : c'est ce qui fait la
différence. component: import('./Admin.vue') chargerait le module dès la
lecture du fichier et supprimerait le découpage, sans aucun message d'erreur.
Les termes à connaître
- vite build
La commande qui produit le paquet de production dans
dist/. Elle compile les composants, applique la minification et écrit des noms de fichiers empreintés.- Empreinte
Le segment de caractères inséré dans le nom d'un fichier produit, par exemple
index-Ba7x9Kd2.js. Il change dès que le contenu change, ce qui permet de mettre le fichier en cache sans risque.- Découpage dynamique
L'effet d'un
import()dans le code : Rollup place le module importé dans un fichier séparé, chargé seulement quand l'expression est évaluée.- manualChunks
Option de sortie de Rollup, sous
build.rollupOptions.output, qui permet de décider à quel fichier appartient un module. Elle accepte un objet ou une fonction.- defineAsyncComponent
Fonction de Vue qui enveloppe un
import()de composant. Le composant n'est résolu qu'au moment où il doit être rendu.- Secouage d'arbre
L'élimination, au build, du code exporté mais jamais importé. Il suppose des modules ES et des imports nommés, et un effet de bord au niveau du module le neutralise.
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.