Kurs Vue.js · Moduł 11: Pinia
State w Pinia
W tej lekcji5
State to reaktywne dane przechowywane w store - jak baza danych głównego komputera NOVA LAB. Każdy odczyt sensora, każdy parametr misji jest tu zapisany i dostępny dla wszystkich modułów stacji.
Definiowanie state
W Composition API style state to zwykłe ref() i reactive():
import { defineStore } from 'pinia'
import { ref, reactive } from 'vue'
export const useResourceStore = defineStore('resources', () => {
// Proste wartości - ref()
const oxygen = ref(98.5)
const water = ref(1250)
const energy = ref(87)
const isEmergency = ref(false)
// Obiekty - reactive() lub ref()
const crew = reactive({
commander: 'Nova',
engineer: 'Atlas',
scientist: 'Darwin'
})
// Tablice
const logs = ref([])
return { oxygen, water, energy, isEmergency, crew, logs }
})Modyfikacja state
State można modyfikować bezpośrednio w actions lub z komponentu:
export const useResourceStore = defineStore('resources', () => {
const oxygen = ref(98.5)
// Action modyfikuje state
function consumeOxygen(amount) {
oxygen.value = Math.max(0, oxygen.value - amount)
}
return { oxygen, consumeOxygen }
})<script setup>
const store = useResourceStore()
// Bezpośrednia modyfikacja (działa, ale actions są lepsze)
store.oxygen = 95.0
// Przez action (zalecane)
store.consumeOxygen(3.5)
</script>$patch - aktualizacja wielu właściwości
$patch pozwala zaktualizować wiele właściwości state jednocześnie - to bardziej wydajne niż modyfikacja po jednej:
const store = useResourceStore()
// Obiekt patch - proste nadpisanie
store.$patch({
oxygen: 95.0,
water: 1200,
energy: 82,
isEmergency: false
})
// Funkcja patch - dla złożonych operacji
store.$patch((state) => {
state.oxygen -= 3.5
state.logs.push({
type: 'consumption',
timestamp: Date.now()
})
})$reset - przywracanie stanu początkowego
W Options API style $reset() działa automatycznie. W Composition API musisz zdefiniować własną funkcję reset:
export const useResourceStore = defineStore('resources', () => {
const oxygen = ref(100)
const water = ref(1500)
const energy = ref(100)
// Custom reset dla Composition API
function $reset() {
oxygen.value = 100
water.value = 1500
energy.value = 100
}
return { oxygen, water, energy, $reset }
})
// Użycie
const store = useResourceStore()
store.$reset() // Przywraca wartości początkowe$state - dostęp do całego stanu
const store = useResourceStore()
// Odczyt całego state
const snapshot = store.$state
// Nadpisanie całego state
store.$state = {
oxygen: 100,
water: 1500,
energy: 100,
isEmergency: false,
crew: { commander: 'Nova' },
logs: []
}Kod do tej lekcji: App.vue
<script setup>
import { ref, computed } from 'vue'
// Symulacja store zasobów
const oxygen = ref(98.5)
const water = ref(1250)
const energy = ref(87)
const logs = ref([])
// Getters
const oxygenStatus = computed(() => oxygen.value > 50 ? 'OK' : 'LOW')
const waterStatus = computed(() => water.value > 500 ? 'OK' : 'LOW')
const energyStatus = computed(() => energy.value > 40 ? 'OK' : 'LOW')
// Actions
function consumeOxygen(amount) {
oxygen.value = Math.max(0, +(oxygen.value - amount).toFixed(1))
addLog('Zużyto tlen: -' + amount + '%')
}
function consumeWater(amount) {
water.value = Math.max(0, water.value - amount)
addLog('Zużyto wodę: -' + amount + ' L')
}
function consumeEnergy(amount) {
energy.value = Math.max(0, energy.value - amount)
addLog('Zużyto energię: -' + amount + '%')
}
function addLog(message) {
logs.value.unshift({
message,
time: new Date().toLocaleTimeString()
})
if (logs.value.length > 8) logs.value.pop()
}
// Symulacja $patch
function patchResources(updates) {
if (updates.oxygen !== undefined) oxygen.value = updates.oxygen
if (updates.water !== undefined) water.value = updates.water
if (updates.energy !== undefined) energy.value = updates.energy
addLog('Zasoby zaktualizowane przez $patch')
}
function resetResources() {
oxygen.value = 100
water.value = 1500
energy.value = 100
logs.value = []
}
</script>
<template>
<div class="nova-lab">
<h1>NOVA LAB - zarządzanie stanem</h1>
<div class="grid">
<div class="resource-panel">
<h2>Zasoby</h2>
<div class="resource" v-for="r in [
{ name: 'Tlen', value: oxygen, unit: '%', status: oxygenStatus, action: () => consumeOxygen(5) },
{ name: 'Woda', value: water, unit: 'L', status: waterStatus, action: () => consumeWater(50) },
{ name: 'Energia', value: energy, unit: '%', status: energyStatus, action: () => consumeEnergy(10) }
]" :key="r.name">
<div class="r-header">
<span>{{ r.name }}</span>
<span :class="r.status.toLowerCase()">{{ r.status }}</span>
</div>
<div class="r-value">{{ r.value }}{{ r.unit }}</div>
<button @click="r.action" class="btn-sm">Zużyj</button>
</div>
<div class="btn-group">
<button @click="patchResources({ oxygen: 50, water: 800 })" class="btn">
$patch (O2=50, H2O=800)
</button>
<button @click="resetResources" class="btn btn-reset">
$reset
</button>
</div>
</div>
<div class="log-panel">
<h2>Dziennik aktywności</h2>
<div v-for="(log, i) in logs" :key="i" class="log-entry">
<span class="log-time">{{ log.time }}</span>
{{ log.message }}
</div>
<p v-if="!logs.length" class="empty">Brak aktywności...</p>
</div>
</div>
</div>
</template>
<style scoped>
.nova-lab {
background: #0a0e27;
color: #00ff88;
min-height: 100vh;
padding: 20px;
font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 20px; text-align: center; }
h2 { color: #00b4d8; margin-bottom: 15px; }
.grid { display: grid; grid-template-columns: 1fr 1fr; gap: 15px; max-width: 700px; margin: 0 auto; }
.resource-panel, .log-panel {
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
padding: 15px;
}
.resource {
background: rgba(0, 255, 136, 0.05);
border: 1px solid #00ff88;
padding: 10px;
margin-bottom: 8px;
}
.r-header { display: flex; justify-content: space-between; margin-bottom: 5px; }
.r-value { font-size: 1.2em; font-weight: bold; margin-bottom: 5px; }
.ok { color: #00ff88; }
.low { color: #ff4444; }
.btn-sm {
background: #00b4d8;
color: #0a0e27;
border: none;
padding: 4px 12px;
cursor: pointer;
font-family: monospace;
}
.btn-group { display: flex; gap: 8px; margin-top: 10px; flex-wrap: wrap; }
.btn {
background: #00b4d8;
color: #0a0e27;
border: none;
padding: 8px 12px;
cursor: pointer;
font-family: monospace;
font-size: 0.85em;
}
.btn:hover { background: #00ff88; }
.btn-reset { background: #ff9900; }
.log-entry {
padding: 5px 0;
border-bottom: 1px solid rgba(0, 180, 216, 0.3);
font-size: 0.85em;
}
.log-time { color: #00b4d8; margin-right: 8px; }
.empty { color: #666; font-style: italic; }
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Jak zdefiniować state w Composition API style?
2. Do czego służy $patch() w Pinia?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Stwórz store z ref() state, action consumeOxygen i action patchResources.
- Układanie w pionie
Ułóż kroki konfiguracji Pinia w main.js:
- Klikanie w kolejności
Ułóż kod destrukturyzacji store z zachowaniem reaktywności:
- Edytor kodu
Stwórz patchUpdate (ustawia wartości) i patchFunction (zmniejsza o 10%).