Formations — 1 037 leçons en français

Accueil › Vue.js › Un appel, une instance d'état

Un appel, une instance d'état

Les composablesintermediaire

Un composable est une fonction. Son corps s'exécute à chaque appel. Ce qu'il déclare à l'intérieur est donc neuf à chaque fois.

export function useCompteur() {
  const n = ref(0)
  function incrementer() { n.value++ }
  return { n, incrementer }
}

Deux composants qui appellent useCompteur() obtiennent deux compteurs indépendants. Même un seul composant qui l'appelle deux fois obtient deux compteurs.

const panier = useCompteur()
const favoris = useCompteur()
panier.incrementer()
console.log(panier.n.value, favoris.n.value)  // 1 0

C'est le comportement voulu, et c'est ce qui sépare un composable d'un store. Deux tableaux paginés veulent chacun leur page courante ; deux champs de recherche veulent chacun leur terme. Un composable réutilise la logique, pas les données.

La conséquence pratique est importante. Un composable ne peut pas servir de canal de communication entre deux composants. Si Entete et BarreLaterale appellent tous deux useUtilisateur(), chacun charge son utilisateur, et une déconnexion dans l'un laisse l'autre connecté.

Dès que plusieurs composants doivent voir le même état, il faut sortir cet état du corps de la fonction : un store Pinia dans la majorité des cas, ou un état déclaré au niveau du module — avec les précautions de la leçon suivante.

Les termes à connaître

Instance d'état

L'ensemble des ref créées par un appel de composable. Deux appels produisent deux ensembles indépendants.

Portée d'appel

Le corps d'un composable s'exécute à chaque appel, comme toute fonction. Les variables qu'il déclare vivent dans cette exécution.

Store

Un conteneur d'état partagé par toute l'application, créé une fois. En Vue, c'est le rôle de Pinia.

Fermeture

Le mécanisme JavaScript par lequel les fonctions renvoyées par un composable gardent accès aux variables de son appel.

Logique partagée

Ce qu'un composable réutilise vraiment : le code, pas les données. Chaque appelant repart d'un état neuf.

Pinia

La bibliothèque de gestion d'état recommandée pour Vue 3. Un store Pinia est résolu une seule fois par application.

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.