5. Gemeinsamer Zustand
5.1. Beispiel 15: Gemeinsamer Zustand mit Pinia
In einer Anwendung sind bestimmte Daten für viele Komponenten relevant: der angemeldete Benutzer, der Warenkorb usw. Beispiel 11 teilte diese Daten mit [provide] / [inject], während Beispiel 14 ein [ref]-Modul verwendete. [Pinia], die offizielle Bibliothek von [Vue.js] für gemeinsamen Zustand, organisiert dies in Stores und macht sie in der Erweiterung [Vue.js devtools] sichtbar.
Sie wird in [main.ts] installiert:
| // =========================================================================
// 15-pinia/src/main.ts
// -------------------------------------------------------------------------
// app.use(createPinia()): Pinia, die offizielle Vue.js-Bibliothek
// für die Verwaltung von GEMEINSAMEM Zustand, wird installiert. Die als Nächstes definierten "Stores"
// sind aus jeder Komponente zugänglich.
// =========================================================================
import { createApp } from 'vue';
import { createPinia } from 'pinia';
import 'bootstrap/dist/css/bootstrap.min.css';
import App from './App.vue';
createApp(App).use(createPinia()).mount('#app');
|
Der erste Store, der Warenkorb:
| // =========================================================================
// 15-pinia/src/stores/cart.ts - ein Pinia-STORE
// -------------------------------------------------------------------------
// defineStore('cart', () => { ... }): ein Store, der wie ein Composable geschrieben ist
// (Stil "setup"):
// - die Refs sind der ZUSTAND des Stores;
// - die Computed-Werte seine GETTER (berechnete Werte);
// - die Funktionen seine ACTIONS (das, was den Zustand ändert).
// Unterschied zu einem Composable (Beispiel 11): Der Store existiert nur in EINER
// Kopie für die gesamte Anwendung. Alle Komponenten, die
// useCartStore() aufrufen, erhalten DENSELBEN Warenkorb. Er lebt so lange, wie die Anwendung
// lebt: Er überlebt das Entfernen einer Komponente ... aber nicht das Neuladen
// der Seite (F5), das die Anwendung neu startet.
// =========================================================================
import { computed, ref } from 'vue';
import { defineStore } from 'pinia';
export interface Item {
label: string;
price: number;
}
export const useCartStore = defineStore('cart', () => {
const items = ref<Item[]>([]);
const count = computed(() => items.value.length);
const total = computed(() => items.value.reduce((s, a) => s + a.price, 0));
function add(item: Item): void {
items.value.push(item);
}
function clear(): void {
items.value = [];
}
// alles, was zurückgegeben wird, gehört zum Store
return { items, count, total, add, clear };
});
|
- Zeilen 24–39: [defineStore(name, function)] definiert einen Store im „Setup“-Stil, wie ein Composable: Die [ref] sind sein Zustand, die [computed] sind seine Getter, und die Funktionen sind seine Aktionen; er stellt bereit, was die Funktion zurückgibt;
- Der Unterschied zu einem Composable: Es gibt nur eine Instanz des Stores für die gesamte Anwendung. Alle Komponenten, die [useCartStore()] aufrufen, erhalten DENSELBEN Warenkorb. Er lebt so lange wie die Anwendung: Er überlebt das Entfernen einer Komponente ... aber nicht das Neuladen der Seite (F5), das die Anwendung neu startet.
Ein zweiter Store überlebt dagegen das Neuladen der Seite:
| // =========================================================================
// 15-pinia/src/stores/preferences.ts - ein Store, der F5 überlebt
// -------------------------------------------------------------------------
// Damit ein Datum das Neuladen der Seite oder das Schließen
// des Browsers überlebt, muss es IM Browser gespeichert werden: localStorage (ein
// kleines Wörterbuch Schlüssel -> String, spezifisch für jede Site).
// - beim Start liest der Store localStorage erneut;
// - watch(..., { deep: true }) schreibt localStorage bei jeder Änderung neu.
// Speichern Sie dort NIEMALS sensible Daten (Passwort, Token): Jedes Skript
// der Seite kann localStorage lesen.
// =========================================================================
import { ref, watch } from 'vue';
import { defineStore } from 'pinia';
const KEY = 'example15.preferences';
interface Preferences {
dark: boolean;
size: number; // Textgröße in px
}
function read(): Preferences {
try {
return { dark: false, size: 16, ...JSON.parse(localStorage.getItem(KEY) ?? '{}') };
} catch {
return { dark: false, size: 16 }; // unlesbarer Inhalt: Standardwerte
}
}
export const usePreferencesStore = defineStore('preferences', () => {
const preferences = ref<Preferences>(read());
watch(preferences, (p) => localStorage.setItem(KEY, JSON.stringify(p)), { deep: true });
return { preferences };
});
|
- Zeilen 23–29: Beim Start liest der Browser [localStorage] erneut aus, ein kleines Schlüssel-Wert-Wörterbuch, das der Browser für jede Website speichert, auch nach dem Schließen des Browsers. Ist der Inhalt nicht lesbar, werden die Standardwerte verwendet;
- Zeile 34: [{ deep: true }]: [watch] reagiert auch auf Änderungen der Eigenschaften des Objekts. Jede Änderung wird erneut in [localStorage] geschrieben.
Speichern Sie NIEMALS sensible Daten (Passwörter, Token) in [localStorage]: Jedes auf der Seite ausgeführte Skript kann [localStorage] lesen.
Die Komponenten:
| <!-- 15-pinia/src/components/Shop.vue - FÜGT dem gemeinsamen Warenkorb HINZU -->
<script setup lang="ts">
import { useCartStore, type Item } from '../stores/cart';
const cart = useCartStore();
const products: Item[] = [
{ label: 'Consultation', price: 30 },
{ label: 'Vaccine', price: 12.5 },
];
</script>
<template>
<div class="card p-3 h-100">
<h2 class="h6">Shop</h2>
<button v-for="p in products" :key="p.label" class="btn btn-sm btn-outline-primary mb-2" @click="cart.add(p)">
+ {{ p.label }} (€{{ p.price }})
</button>
</div>
</template>
|
- Zeile 5: Der Store wird wie ein reaktives Objekt verwendet: [cart.add(p)];
| <!--
15-pinia/src/components/CartSummary.vue - READS the same cart
storeToRefs: to DESTRUCTURE a store without losing reactivity
(const { count } = cart would give a simple, frozen copy).
-->
<script setup lang="ts">
import { storeToRefs } from 'pinia';
import { useCartStore } from '../stores/cart';
const cart = useCartStore();
const { count, total } = storeToRefs(cart);
</script>
<template>
<div class="card p-3 h-100">
<h2 class="h6">Cart</h2>
<p class="mb-2">{{ count }} item(s), €{{ total }}</p>
<!-- die Actions hingegen können destrukturiert oder direkt aufgerufen werden -->
<button class="btn btn-sm btn-outline-danger align-self-start" :disabled="count === 0" @click="cart.clear()">Clear</button>
</div>
</template>
|
- Zeile 11: um einen Store zu destrukturieren, ohne die Reaktivität zu verlieren. [const { count } = cart] würde eine einfache Kopie liefern, eingefroren auf dem aktuellen Wert; [storeToRefs] liefert [ref]-Instanzen, die mit dem Store verbunden sind. Aktionen hingegen können destrukturiert oder direkt aufgerufen werden.
| <!-- 15-pinia/src/components/LocalCounter.vue - ein LOKALER Zustand, der mit der Komponente verschwindet -->
<script setup lang="ts">
import { ref } from 'vue';
const clicks = ref(0);
</script>
<template>
<div class="card p-3 h-100">
<h2 class="h6">Local state</h2>
<button class="btn btn-sm btn-outline-secondary align-self-start" @click="clicks++">{{ clicks }} click(s)</button>
</div>
</template>
|
| <!--
=========================================================================
15-pinia/src/App.vue - three "scopes" of data on the client side
-------------------------------------------------------------------------
Same question as example 23 of the NestJS course (application,
request, client scope), transposed to the browser:
- the LOCAL state of a component (LocalCounter) disappears with it;
- the state of a STORE (the cart) is shared by all the components and
survives their removal - but not F5;
- the state stored in localStorage (the preferences) survives F5 and the
closing of the browser.
Uncheck then check the box again, then reload the page: compare.
=========================================================================
-->
<script setup lang="ts">
import { ref } from 'vue';
import { usePreferencesStore } from './stores/preferences';
import Shop from './components/Shop.vue';
import CartSummary from './components/CartSummary.vue';
import LocalCounter from './components/LocalCounter.vue';
const prefs = usePreferencesStore();
const areaVisible = ref(true);
</script>
<template>
<div :class="{ 'bg-dark text-light': prefs.preferences.dark }" :style="{ fontSize: prefs.preferences.size + 'px' }" class="min-vh-100">
<div class="container py-4">
<h1 class="h3 mb-3">Example 15 - a shared state with Pinia</h1>
<div class="d-flex flex-wrap gap-4 mb-3">
<label class="form-check-label"><input v-model="prefs.preferences.dark" type="checkbox" class="form-check-input"> dark theme</label>
<label>text size <input v-model.number="prefs.preferences.size" type="range" min="12" max="22"> {{ prefs.preferences.size }} px</label>
<label class="form-check-label"><input v-model="areaVisible" type="checkbox" class="form-check-input"> show the area</label>
</div>
<div v-if="areaVisible" class="row g-3 text-body">
<div class="col-md-4"><Shop /></div>
<div class="col-md-4"><CartSummary /></div>
<div class="col-md-4"><LocalCounter /></div>
</div>
<p class="mt-3 mb-2">Outside the area, a second summary of the SAME cart (it stays there when the area disappears):</p>
<div class="text-body"><CartSummary /></div>
</div>
</div>
</template>
|
- Zeile 35: Das Abwählen von „Bereich anzeigen“ entfernt die drei Komponenten von der Seite;
- Zeile 41: eine zweite Zusammenfassung desselben Warenkorbs, außerhalb des Bereichs.
Dieselbe Frage wie in Beispiel 23 des Kurses [NestJS] (Gültigkeitsbereiche Anwendung, Anfrage und Client), für den Browser angepasst:
Daten | Wo? | Lebensdauer |
Der Zähler von LocalCounter | der lokale Zustand der Komponente | verschwindet mit der Komponente |
der Warenkorb | ein Pinia-Store | die gesamte Anwendung, bis F5 |
Einstellungen | ein Pinia-Store + localStorage | überlebt F5 und das Schließen des Browsers |
Zwei Artikel hinzugefügt und zwei Klicks:

Der Bereich wurde entfernt und das dunkle Design ausgewählt: Der Warenkorb ist weiterhin vorhanden; wird der Bereich erneut angezeigt, wird der lokale Zähler auf null zurückgesetzt:
