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
refdé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.
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.