Kurs Vue.js · Moduł 11: Pinia
Composition API Stores (setup syntax)
W tej lekcji5
W NOVA LAB każdy system ma swój protokół konfiguracji. Pinia oferuje dwa style definiowania stores - Composition API (setup function) i Options API. Pinia nie zaleca żadnego z nich: Options API jest prostszy na start, a Composition API daje więcej elastyczności i przypomina sposób, w jaki piszemy komponenty Vue 3.
Composition API vs Options API
// Composition API (setup store)
export const useCounterStore = defineStore('counter', () => {
const count = ref(0)
const doubleCount = computed(() => count.value * 2)
function increment() { count.value++ }
return { count, doubleCount, increment }
})
// Options API
export const useCounterStore = defineStore('counter', {
state: () => ({ count: 0 }),
getters: {
doubleCount: (state) => state.count * 2
},
actions: {
increment() { this.count++ }
}
})Kiedy wybrać który styl?
| Aspekt | Composition API | Options API |
|---|---|---|
| Elastyczność | Pełna | Ograniczona |
| TypeScript | Naturalne typowanie | Wymaga deklaracji |
$reset() | Trzeba zdefiniować ręcznie | Działa automatycznie |
| Composables | Łatwe do użycia | Trudniejsze |
| Składnia | Jak <script setup> | Jak Options API Vue |
Użycie composables w store
Composition API pozwala łatwo używać composables wewnątrz store:
import { defineStore } from 'pinia'
import { ref, computed, watch } from 'vue'
import { useLocalStorage } from '@vueuse/core'
export const useSettingsStore = defineStore('settings', () => {
// Composable w store!
const theme = useLocalStorage('theme', 'dark')
const language = useLocalStorage('language', 'pl')
const isDark = computed(() => theme.value === 'dark')
function toggleTheme() {
theme.value = isDark.value ? 'light' : 'dark'
}
return { theme, language, isDark, toggleTheme }
})Watchers w store
Możesz używać watch i watchEffect wewnątrz store:
export const useAlertStore = defineStore('alerts', () => {
const temperature = ref(22)
const alerts = ref([])
// Watcher reagujący na zmiany
watch(temperature, (newTemp, oldTemp) => {
if (newTemp > 50) {
alerts.value.push({
type: 'critical',
message: `Temperature critical: ${newTemp}°C`,
timestamp: Date.now()
})
}
})
function setTemperature(value) {
temperature.value = value
}
return { temperature, alerts, setTemperature }
})Typowanie z TypeScript
interface CrewMember {
id: number
name: string
role: 'commander' | 'engineer' | 'scientist'
active: boolean
}
export const useCrewStore = defineStore('crew', () => {
const members = ref<CrewMember[]>([])
const selected = ref<CrewMember | null>(null)
const activeMembers = computed<CrewMember[]>(() =>
members.value.filter(m => m.active)
)
function addMember(member: Omit<CrewMember, 'id'>): CrewMember {
const newMember: CrewMember = {
...member,
id: Date.now()
}
members.value.push(newMember)
return newMember
}
return { members, selected, activeMembers, addMember }
})Kod do tej lekcji: App.vue
<script setup>
import { ref, computed, watch } from 'vue'
// Store w stylu Composition API z watcherami i wzorcami z TypeScript
const temperature = ref(22)
const alerts = ref([])
const settings = ref({
theme: 'dark',
language: 'pl',
unit: 'celsius'
})
// Watcher wewnątrz store
watch(temperature, (newTemp) => {
if (newTemp > 45) {
alerts.value.push({
id: Date.now(),
type: 'critical',
message: `Temperatura krytyczna: ${newTemp} C`,
time: new Date().toLocaleTimeString()
})
} else if (newTemp > 35) {
alerts.value.push({
id: Date.now(),
type: 'warning',
message: `Wysoka temperatura: ${newTemp} C`,
time: new Date().toLocaleTimeString()
})
}
})
// Getters
const isDark = computed(() => settings.value.theme === 'dark')
const tempDisplay = computed(() => {
if (settings.value.unit === 'fahrenheit') {
return ((temperature.value * 9/5) + 32).toFixed(1) + ' F'
}
return temperature.value + ' C'
})
const criticalAlerts = computed(() =>
alerts.value.filter(a => a.type === 'critical')
)
// Actions
function setTemperature(value) {
temperature.value = Math.max(-100, Math.min(100, value))
}
function toggleTheme() {
settings.value.theme = isDark.value ? 'light' : 'dark'
}
function toggleUnit() {
settings.value.unit = settings.value.unit === 'celsius' ? 'fahrenheit' : 'celsius'
}
function dismissAlert(id) {
alerts.value = alerts.value.filter(a => a.id !== id)
}
function clearAlerts() {
alerts.value = []
}
</script>
<template>
<div class="nova-lab" :class="settings.theme">
<h1>NOVA LAB - store w Composition API</h1>
<div class="temp-control">
<h2>Sterowanie temperaturą</h2>
<div class="temp-display" :class="{ critical: temperature > 45, warning: temperature > 35 }">
{{ tempDisplay }}
</div>
<div class="slider-row">
<button @click="setTemperature(temperature - 5)" class="btn">-5</button>
<input type="range" v-model.number="temperature" min="-50" max="80" class="slider" />
<button @click="setTemperature(temperature + 5)" class="btn">+5</button>
</div>
</div>
<div class="settings-panel">
<h2>Ustawienia (wzorzec composable)</h2>
<button @click="toggleTheme" class="btn">
Motyw: {{ settings.theme }}
</button>
<button @click="toggleUnit" class="btn">
Jednostka: {{ settings.unit }}
</button>
</div>
<div v-if="alerts.length" class="alerts-panel">
<div class="alerts-header">
<h2>Alarmy ({{ alerts.length }})</h2>
<button @click="clearAlerts" class="btn btn-sm">Wyczyść wszystko</button>
</div>
<div v-for="alert in alerts" :key="alert.id"
class="alert-item" :class="alert.type">
<span>{{ alert.time }} - {{ alert.message }}</span>
<button @click="dismissAlert(alert.id)" class="dismiss">x</button>
</div>
</div>
</div>
</template>
<style scoped>
.nova-lab {
min-height: 100vh;
padding: 20px;
font-family: monospace;
transition: all 0.3s;
}
.nova-lab.dark { background: #0a0e27; color: #00ff88; }
.nova-lab.light { background: #f0f4f8; color: #1a1e3f; }
h1 { margin-bottom: 20px; text-align: center; }
h2 { color: #00b4d8; margin-bottom: 10px; }
.temp-control, .settings-panel, .alerts-panel {
max-width: 500px;
margin: 0 auto 15px;
padding: 15px;
border: 2px solid #00b4d8;
background: rgba(0, 180, 216, 0.1);
}
.temp-display {
text-align: center;
font-size: 2em;
font-weight: bold;
margin: 10px 0;
}
.temp-display.warning { color: #ff9900; }
.temp-display.critical { color: #ff4444; }
.slider-row { display: flex; align-items: center; gap: 10px; }
.slider { flex: 1; }
.btn {
background: #00b4d8;
color: #0a0e27;
border: none;
padding: 6px 14px;
cursor: pointer;
font-family: monospace;
margin: 2px;
}
.btn:hover { background: #00ff88; }
.btn-sm { padding: 4px 10px; font-size: 0.85em; }
.alerts-header { display: flex; justify-content: space-between; align-items: center; }
.alert-item {
display: flex;
justify-content: space-between;
align-items: center;
padding: 8px;
margin: 5px 0;
border: 1px solid;
}
.alert-item.warning { border-color: #ff9900; color: #ff9900; }
.alert-item.critical { border-color: #ff4444; color: #ff4444; }
.dismiss {
background: none;
border: 1px solid currentColor;
color: inherit;
cursor: pointer;
padding: 2px 6px;
font-family: monospace;
}
</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. Jaki styl definiowania store zaleca Pinia?
2. Czy można używać watch() wewnątrz store (Composition API)?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w pionie
Uporządkuj elementy store od definiowania do eksportowania:
- Edytor kodu
Zdefiniuj settings store z theme, language, getter isDark i toggleTheme action.
- Układanie w poziomie
Ułóż typowaną definicję state w store:
- Edytor kodu
Zdefiniuj crew store z getterami, actions i custom $reset.