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ùstateest une fonction qui renvoie l'état initial.- Store de composition
Une déclaration sous forme de fonction, où l'on écrit
ref,computedet 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
refindividuelles, 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.
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.