Kurs Vue.js · Moduł 11: Pinia
Plugins i Persistence
W tej lekcji6
System backupów NOVA LAB zapewnia, że krytyczne dane przetrwają nawet restart stacji. W Pinia tę rolę pełnią plugins - rozszerzenia dodające nowe możliwości do stores. Najważniejszy z nich to persistence - zapisywanie state do localStorage.
$subscribe - nasłuchiwanie zmian
$subscribe pozwala reagować na każdą zmianę state:
const store = useResourceStore()
store.$subscribe((mutation, state) => {
console.log('Store changed:', mutation.storeId)
console.log('Type:', mutation.type) // 'direct' | '$patch'
console.log('New state:', state)
// Automatyczny zapis do localStorage
localStorage.setItem('resources', JSON.stringify(state))
})Opcje subscribe:
store.$subscribe(
(mutation, state) => { /* ... */ },
{ detached: true } // Przetrwa unmount komponentu
)$onAction - obserwowanie akcji
const store = useResourceStore()
store.$onAction(({ name, args, after, onError }) => {
console.log(`Action started: ${name}`, args)
after((result) => {
console.log(`Action ${name} completed`, result)
})
onError((error) => {
console.error(`Action ${name} failed`, error)
})
})Plugin persistence
Najpopularniejszy plugin - pinia-plugin-persistedstate:
npm install pinia-plugin-persistedstateKonfiguracja:
// main.js
import { createPinia } from 'pinia'
import piniaPluginPersistedstate from 'pinia-plugin-persistedstate'
const pinia = createPinia()
pinia.use(piniaPluginPersistedstate)Użycie w store:
export const useSettingsStore = defineStore('settings', () => {
const theme = ref('dark')
const language = ref('pl')
return { theme, language }
}, {
persist: true // Cały state do localStorage
})Zaawansowana konfiguracja persist
export const useAuthStore = defineStore('auth', () => {
const token = ref(null)
const user = ref(null)
const tempData = ref(null) // Nie chcemy tego zapisywać
return { token, user, tempData }
}, {
persist: {
// Tylko wybrane pola
pick: ['token'],
// Custom storage
storage: sessionStorage,
// Custom key
key: 'nova-lab-auth'
}
})Tworzenie custom pluginu
Plugin Pinia to funkcja przyjmująca context ze store:
// plugins/logger.js
export function loggerPlugin({ store }) {
store.$subscribe((mutation, state) => {
console.log(`[${mutation.storeId}] ${mutation.type}`)
})
store.$onAction(({ name, store: s, args }) => {
console.log(`[${s.$id}] Action: ${name}`, args)
})
}
// main.js
const pinia = createPinia()
pinia.use(loggerPlugin)Plugin dodający właściwości
function timestampPlugin({ store }) {
// Dodaj lastUpdated do każdego store
store.lastUpdated = ref(null)
store.$subscribe(() => {
store.lastUpdated = new Date()
})
}Kod do tej lekcji: App.vue
<script setup>
import { ref, computed, watch } from 'vue'
// Symulacja store z $subscribe i pluginami
const settings = ref({
theme: 'dark',
language: 'pl',
fontSize: 14
})
const changeLog = ref([])
const actionLog = ref([])
// Symulacja $subscribe
watch(settings, (newVal) => {
changeLog.value.unshift({
time: new Date().toLocaleTimeString(),
change: JSON.stringify(newVal)
})
if (changeLog.value.length > 6) changeLog.value.pop()
// Symulacja persist - zapis do localStorage
try {
localStorage.setItem('nova-settings', JSON.stringify(newVal))
} catch (e) {}
}, { deep: true })
// Symulacja $onAction (plugin logujący)
function logAction(name, args = []) {
actionLog.value.unshift({
time: new Date().toLocaleTimeString(),
action: name,
args: args.length ? JSON.stringify(args) : '-'
})
if (actionLog.value.length > 6) actionLog.value.pop()
}
// Actions
function toggleTheme() {
settings.value.theme = settings.value.theme === 'dark' ? 'light' : 'dark'
logAction('toggleTheme')
}
function setLanguage(lang) {
settings.value.language = lang
logAction('setLanguage', [lang])
}
function changeFontSize(delta) {
settings.value.fontSize = Math.max(10, Math.min(24, settings.value.fontSize + delta))
logAction('changeFontSize', [delta])
}
function resetSettings() {
settings.value = { theme: 'dark', language: 'pl', fontSize: 14 }
logAction('resetSettings')
}
const persistedData = computed(() => {
try {
return localStorage.getItem('nova-settings') || 'Brak danych'
} catch (e) {
return 'Pamięć lokalna niedostępna'
}
})
</script>
<template>
<div class="nova-lab" :class="settings.theme" :style="{ fontSize: settings.fontSize + 'px' }">
<h1>NOVA LAB - pluginy i persistence</h1>
<div class="grid">
<div class="panel">
<h2>Store ustawień</h2>
<div class="setting">
<span>Motyw:</span>
<button @click="toggleTheme" class="btn">{{ settings.theme }}</button>
</div>
<div class="setting">
<span>Język:</span>
<button @click="setLanguage('pl')" class="btn" :class="{ active: settings.language === 'pl' }">PL</button>
<button @click="setLanguage('en')" class="btn" :class="{ active: settings.language === 'en' }">EN</button>
</div>
<div class="setting">
<span>Czcionka:</span>
<button @click="changeFontSize(-2)" class="btn">A-</button>
<span>{{ settings.fontSize }}px</span>
<button @click="changeFontSize(2)" class="btn">A+</button>
</div>
<button @click="resetSettings" class="btn btn-reset">Resetuj wszystko</button>
</div>
<div class="panel">
<h2>Dziennik $subscribe</h2>
<div v-for="(entry, i) in changeLog" :key="i" class="log-entry">
<span class="time">{{ entry.time }}</span>
<span class="change">{{ entry.change }}</span>
</div>
<p v-if="!changeLog.length" class="empty">Brak zmian</p>
</div>
<div class="panel">
<h2>Dziennik $onAction (plugin)</h2>
<div v-for="(entry, i) in actionLog" :key="i" class="log-entry">
<span class="time">{{ entry.time }}</span>
<span class="action-name">{{ entry.action }}</span>
<span class="args">{{ entry.args }}</span>
</div>
<p v-if="!actionLog.length" class="empty">Brak akcji</p>
</div>
<div class="panel">
<h2>Zapisane (localStorage)</h2>
<pre class="persisted">{{ persistedData }}</pre>
</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; font-size: 1em; }
.grid { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; max-width: 700px; margin: 0 auto; }
.panel {
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
padding: 12px;
}
.setting { display: flex; align-items: center; gap: 8px; margin: 8px 0; flex-wrap: wrap; }
.btn {
background: #00b4d8;
color: #0a0e27;
border: none;
padding: 4px 12px;
cursor: pointer;
font-family: monospace;
}
.btn:hover { background: #00ff88; }
.btn.active { background: #00ff88; }
.btn-reset { background: #ff9900; margin-top: 10px; }
.log-entry {
padding: 4px 0;
border-bottom: 1px solid rgba(0, 180, 216, 0.2);
font-size: 0.8em;
display: flex;
gap: 8px;
flex-wrap: wrap;
}
.time { color: #00b4d8; }
.change { color: #00ff88; word-break: break-all; }
.action-name { color: #ff9900; }
.args { color: #666; }
.empty { color: #666; font-style: italic; font-size: 0.85em; }
.persisted {
background: #0a0e27;
color: #00ff88;
padding: 8px;
font-size: 0.75em;
word-break: break-all;
white-space: pre-wrap;
}
</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. Do czego służy $subscribe() w Pinia?
2. Jak dodać persistence (zapis do localStorage) do Pinia store?
To 2 z 6 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Stwórz log store z addLog, clearLogs i plugin logujący zmiany do konsoli.
- Układanie w pionie
Ułóż kroki dodania persistence do store:
- Układanie w pionie
Uporządkuj przepływ nasłuchiwania zmian store:
- Edytor kodu
Stwórz resource store z alertami i statusLevel getter - consume tworzy alerty.
- Klikanie w kolejności
Ułóż kod tworzenia custom pluginu Pinia:
- Układanie w pionie
Uporządkuj opcje persist od najprostszej do najbardziej szczegółowej:
- Układanie w poziomie
Ułóż składnię dostępu do state w komponencie:
- Układanie w pionie
Uporządkuj pełny przepływ danych w aplikacji z Pinia:
- Układanie w poziomie
Ułóż składnię $patch z funkcją callback:
- Klikanie w kolejności
Ułóż pełny lifecycle store w aplikacji:
- Układanie w pionie
Uporządkuj scenariusze od prostszych (provide) do złożonych (Pinia):
- Układanie w pionie
Ułóż kod rejestracji pluginu w main.js:
Zadania po tej lekcji
- Pytanie$subscribe w Pinia
- PytaniePersistence plugin
- Zadanie z kodemPraktyka: $subscribe i persistence
- Ułóż w kolejnościKonfiguracja persistence
- Pytanie$onAction w Pinia
- Ułóż w kolejnościPrzepływ $subscribe
- PytanieCustom plugin
- Zadanie z kodemPraktyka: Kompletny system logowania
- Kliknij w kolejnościPlugin pattern
- Ułóż w kolejnościPersist konfiguracja zaawansowana
- Ułóż w kolejnościDostęp do state w store
- PytanieDevTools w Pinia
- Ułóż w kolejnościPrzepływ danych w Pinia
- PytanieVuex vs Pinia - mutations
- Ułóż w kolejności$patch z funkcją
- Kliknij w kolejnościPełny lifecycle store
- Ułóż w kolejnościKiedy użyć Pinia vs provide/inject?
- Ułóż w kolejnościRejestracja pluginu Pinia