Pinia je oficiální knihovna Vue pro správu stavu (nástupce Vuexu) — centralizované úložiště pro stav, který je potřeba sdílet mezi mnoha komponentami, s jednoduchým a typově bezpečným API postaveným na Composition API.
{ defineStore } ;
{ ref, computed } ;
useCounterStore = (, {
count = ();
double = ( count. * );
() { count.++; }
() { count. = api.(); }
{ count, double, increment, fetchInitial };
});
Toto "setup úložiště" vypadá přesně jako composable — ref pro stav, computed pro gettery, funkce pro akce — což je intuitivní, pokud znáte Composition API.
<script setup>
import { useCounterStore } from "@/stores/counter";
import { storeToRefs } from "pinia";
const store = useCounterStore();
const { count, double } = storeToRefs(store); // keep state reactive when destructured
const { increment } = store; // actions can be destructured directly
</script>
<template>
<button @click="increment">{{ count }} (x2 = {{ double }})</button>
</template>
Důležité: použijte storeToRefs při destrukturování stavu/getterů — běžná destrukturování by narušila reaktivitu (stejné upozornění na reaktivitu jako u reactive). Akce to nepotřebují.
✓ No mutations boilerplate — actions can mutate state directly
✓ Excellent TypeScript inference (Vuex was painful to type)
✓ Modular by design — many small stores, no nested-module complexity
✓ Composition-API-native, tiny API, devtools support
props/emits → parent ↔ child
provide/inject → share within a subtree
Pinia store → GLOBAL/app-wide shared state (auth user, cart, settings)
accessed by many unrelated components
Pinia je standardním řešením pro globální, sdílený stav v aplikacích Vue — uživatel/autentifikace, nákupní košíky, nastavení aplikace, cachovaná data — cokoli, co musí mnoho vzdálených komponent konzistentně číst a aktualizovat.
Její composable-style API, nativní podpora TypeScriptu a absence Vuexova kódu ji činí doporučenou volbou.
Znalost kdy se na ni obrátit (místo props/inject), když je stav skutečně globální, a používání storeToRefs k zachování reaktivity při destrukturování, je základem správného použití.