Formations — 1 037 leçons en français

Accueil › Vue.js › Définir un store avec defineStore

Définir un store avec defineStore

Pinia et l'état partagéintermediaire

Un store Pinia se déclare avec defineStore, et s'utilise en appelant la fonction qu'elle renvoie.

// stores/panier.ts
import { defineStore } from 'pinia'

export const usePanier = defineStore('panier', {
  state: () => ({ lignes: [] as Ligne[] }),
  getters: {
    total: (etat) => etat.lignes.reduce((s, l) => s + l.prix * l.quantite, 0),
  },
  actions: {
    ajouter(ligne: Ligne) { this.lignes.push(ligne) },
  },
})

Trois parties, et une seule idée derrière chacune : state est la donnée, getters sont les valeurs dérivées, actions sont les modifications. La même déclaration s'écrit en store de composition, avec les outils du chapitre sur la réactivité :

export const usePanier = defineStore('panier', () => {
  const lignes = ref<Ligne[]>([])
  const total = computed(() => lignes.value.reduce((s, l) => s + l.prix * l.quantite, 0))
  function ajouter(ligne: Ligne) { lignes.value.push(ligne) }
  return { lignes, total, ajouter }
})

ref tient lieu de state, computed de getters, une fonction ordinaire d'action. Les deux formes produisent le même store.

Avant tout usage, Pinia doit être installé sur l'application :

import { createPinia } from 'pinia'
createApp(App).use(createPinia()).mount('#app')

Dans un composant, on appelle la fonction, et on déstructure avec précaution :

const panier = usePanier()
const { total } = storeToRefs(panier)   // état et getters
const { ajouter } = panier              // actions : déstructuration sûre

Déstructurer directement const { total } = panier extrait un nombre figé. C'est l'erreur la plus fréquente du chapitre.

Les termes à connaître

Store

Un conteneur d'état réactif vivant hors des composants, partagé par tous ceux qui l'utilisent, et accessible sans le faire transiter par les props.

defineStore

La fonction de Pinia qui déclare un store. Elle prend un identifiant unique et une description, et renvoie une fonction qu'on appelle dans un composant pour obtenir l'instance.

Store d'options

Une déclaration en trois clés — state, getters, actions — proche de la forme de Vuex, où state est une fonction qui renvoie l'état initial.

Store de composition

Une déclaration sous forme de fonction, où l'on écrit ref, computed et fonctions ordinaires, puis où l'on renvoie ce qu'on expose.

storeToRefs

Un utilitaire qui transforme l'état et les getters d'un store en ref individuelles, pour pouvoir les déstructurer sans perdre la réactivité.

createPinia

La fabrique qui crée l'instance de Pinia. On l'installe sur l'application avec app.use() avant tout montage.

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.