Kurs Vue.js · Moduł 11: Pinia
Podstawy Pinia
W tej lekcji5
Witaj w Centralnej Bazie Danych NOVA LAB! Rok 2087 - tu przechowujemy wszystkie krytyczne dane misji marsjańskiej. Podobnie jak główny komputer bazy przechowuje informacje o systemach, załodze i zasobach, Pinia przechowuje globalny stan aplikacji Vue.
Czym jest Pinia?
Pinia to oficjalna biblioteka state management dla Vue 3. Jest następcą Vuex i oferuje znacznie prostszą składnię. Wyobraź sobie ją jako centralny komputer NOVA LAB - jeden punkt kontroli, z którego wszystkie moduły stacji pobierają dane.
Główne zalety Pinia:
- Prostsza składnia niż Vuex (brak mutations!)
- Pełne wsparcie TypeScript
- Świetna integracja z Vue DevTools
- Modułowa architektura - wiele niezależnych stores
Instalacja i konfiguracja
Aby uruchomić Pinia, potrzebujemy dwóch kroków - zainstalować pakiet i podłączyć go do aplikacji:
npm install pinia// main.js
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'
const pinia = createPinia()
const app = createApp(App)
app.use(pinia)
app.mount('#app')Funkcja createPinia() tworzy instancję Pinia, a app.use(pinia) rejestruje ją jako plugin Vue. Od tego momentu wszystkie stores są dostępne w całej aplikacji.
Definiowanie Store - defineStore
Store tworzymy za pomocą defineStore. Przyjmuje dwa argumenty: unikalną nazwę store i funkcję setup (Composition API style):
// stores/mission.js
import { defineStore } from 'pinia'
import { ref, computed } from 'vue'
export const useMissionStore = defineStore('mission', () => {
// State - dane reaktywne
const missionName = ref('Mars Exploration Alpha')
const status = ref('active')
const crewCount = ref(6)
// Getters - wartości wyliczane
const statusLabel = computed(() =>
status.value === 'active' ? 'AKTYWNA' : 'NIEAKTYWNA'
)
// Actions - funkcje modyfikujące state
function updateStatus(newStatus) {
status.value = newStatus
}
// Zwracamy wszystko co ma być dostępne
return {
missionName,
status,
crewCount,
statusLabel,
updateStatus
}
})Konwencja nazewnictwa: useXxxStore - prefix use i suffix Store.
Użycie store w komponencie
<script setup>
import { useMissionStore } from '@/stores/mission'
const missionStore = useMissionStore()
// Dostęp do state
console.log(missionStore.missionName)
// Wywołanie action
missionStore.updateStatus('completed')
</script>
<template>
<div>
<h1>{{ missionStore.missionName }}</h1>
<p>Status: {{ missionStore.statusLabel }}</p>
<button @click="missionStore.updateStatus('paused')">
Wstrzymaj misję
</button>
</div>
</template>storeToRefs - reaktywna destrukturyzacja
Zwykła destrukturyzacja traci reaktywność. Użyj storeToRefs dla state i getters:
<script setup>
import { useMissionStore } from '@/stores/mission'
import { storeToRefs } from 'pinia'
const store = useMissionStore()
// State i getters - storeToRefs (zachowuje reaktywność)
const { missionName, status, statusLabel } = storeToRefs(store)
// Actions - normalna destrukturyzacja (to funkcje, nie refs)
const { updateStatus } = store
</script>Kod do tej lekcji: App.vue
<script setup>
import { ref, computed } from 'vue'
// Symulacja store Pinia (w stylu Composition API)
// W prawdziwej aplikacji: import { defineStore } from 'pinia'
// State
const missionName = ref('Eksploracja Marsa Alfa')
const status = ref('active')
const crewCount = ref(6)
const fuelLevel = ref(87)
// Getters
const statusLabel = computed(() =>
status.value === 'active' ? 'AKTYWNA' : 'NIEAKTYWNA'
)
const fuelStatus = computed(() => {
if (fuelLevel.value > 70) return 'Optimal'
if (fuelLevel.value > 30) return 'Moderate'
return 'Critical'
})
// Actions
function toggleStatus() {
status.value = status.value === 'active' ? 'paused' : 'active'
}
function consumeFuel(amount) {
fuelLevel.value = Math.max(0, fuelLevel.value - amount)
}
function refuel() {
fuelLevel.value = 100
}
</script>
<template>
<div class="nova-lab">
<h1>NOVA LAB - podstawy Pinia</h1>
<div class="panel">
<h2>Store misji</h2>
<div class="stat">
<span class="label">Misja:</span>
<span>{{ missionName }}</span>
</div>
<div class="stat">
<span class="label">Status:</span>
<span :class="status">{{ statusLabel }}</span>
</div>
<div class="stat">
<span class="label">Załoga:</span>
<span>{{ crewCount }} osób</span>
</div>
<div class="stat">
<span class="label">Paliwo:</span>
<div class="fuel-bar">
<div class="fuel-fill" :style="{ width: fuelLevel + '%' }" :class="fuelStatus.toLowerCase()"></div>
</div>
<span>{{ fuelLevel }}% ({{ fuelStatus }})</span>
</div>
<div class="actions">
<button @click="toggleStatus" class="btn">
{{ status === 'active' ? 'Wstrzymaj' : 'Wznów' }}
</button>
<button @click="consumeFuel(10)" class="btn btn-warn">
Zużyj paliwo (-10)
</button>
<button @click="refuel" class="btn btn-success">
Zatankuj
</button>
</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; }
.panel {
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
padding: 20px;
max-width: 500px;
margin: 0 auto;
}
h2 { color: #00b4d8; margin-bottom: 15px; }
.stat {
display: flex;
align-items: center;
gap: 10px;
margin: 10px 0;
flex-wrap: wrap;
}
.label { color: #00b4d8; min-width: 80px; }
.active { color: #00ff88; font-weight: bold; }
.paused { color: #ff9900; font-weight: bold; }
.fuel-bar {
width: 150px;
height: 16px;
background: #1a1e3f;
border: 1px solid #00b4d8;
}
.fuel-fill {
height: 100%;
transition: width 0.3s;
}
.fuel-fill.optimal { background: #00ff88; }
.fuel-fill.moderate { background: #ff9900; }
.fuel-fill.critical { background: #ff4444; }
.actions {
display: flex;
gap: 8px;
margin-top: 15px;
flex-wrap: wrap;
}
.btn {
background: #00b4d8;
color: #0a0e27;
border: none;
padding: 8px 16px;
cursor: pointer;
font-family: monospace;
font-weight: bold;
}
.btn:hover { background: #00ff88; }
.btn-warn { background: #ff9900; }
.btn-warn:hover { background: #ffbb33; }
.btn-success { background: #00ff88; }
.btn-success:hover { background: #33ffaa; }
</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. Czym jest Pinia w ekosystemie Vue 3?
2. Jak utworzyć instancję Pinia w main.js?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Stwórz stan reaktywny (missionName, status, crewCount) i akcję toggleStatus.
- Klikanie w kolejności
Ułóż kod definiowania store o nazwie 'mission':
- Edytor kodu
Użyj storeToRefs do destrukturyzacji state i wywołaj action z template.