Formations — 1 037 leçons en français

Accueil › Vue.js › L'état au niveau module

L'état au niveau module

Les composablesintermediaire

Déplacer une ref hors du corps du composable change tout. Elle n'est plus créée à chaque appel : elle est créée une fois, au chargement du module.

// composables/useTheme.ts
import { ref } from 'vue'

const sombre = ref(false)          // niveau module : un seul exemplaire

export function useTheme() {
  function basculer() { sombre.value = !sombre.value }
  return { sombre, basculer }
}

Tous les composants qui appellent useTheme() reçoivent désormais la même ref. Basculer depuis l'en-tête change le thème lu par le pied de page. C'est le motif qu'on appelle parfois « composable à état global ».

Il est simple, et il a trois conséquences qu'il faut connaître avant de l'employer.

L'état est partagé par tous les appelants, y compris ceux dont on n'avait pas prévu qu'ils l'appelleraient. L'état survit au démontage : un changement de route laisse la valeur en place, avec le message d'erreur du formulaire précédent si on y a mis un message d'erreur. Et côté serveur, le module est chargé une fois pour toutes les requêtes du processus : l'état d'un utilisateur devient visible par le suivant.

Pour un thème ou l'ouverture d'un menu, le motif convient. Pour des données métier, préférez un store Pinia : son état est construit par une fonction appelée une fois par instance d'application, ce qui résout précisément le problème du serveur.

Les termes à connaître

État de module

Une ref déclarée hors du corps du composable, dans la portée du module. Elle est créée une seule fois et partagée par tous les appels.

Singleton de module

Un module ES est évalué une fois par graphe de modules. Tout ce qu'il déclare à son niveau supérieur existe en un seul exemplaire.

Fuite d'état entre requêtes

En rendu côté serveur, un état de module est partagé par toutes les requêtes du processus, donc entre utilisateurs différents.

Rendu côté serveur

Le rendu des composants dans un processus Node avant envoi du HTML. Le module y est chargé une fois, et le serveur sert plusieurs requêtes.

Persistance entre routes

Un état de module survit au démontage des composants, donc à un changement de page du routeur.

Fabrique de state

Une fonction qui crée l'état à la demande, plutôt que de l'évaluer au chargement du module. C'est le principe du state() d'un store Pinia.

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.