Kurs Vue.js · Moduł 11: Pinia

Plugins i Persistence

2 min czytania ·
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-persistedstate

Konfiguracja:

// 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. 1. Do czego służy $subscribe() w Pinia?

  2. 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:

  1. Pytanie$subscribe w Pinia
  2. PytaniePersistence plugin
  3. Zadanie z kodemPraktyka: $subscribe i persistence
  4. Ułóż w kolejnościKonfiguracja persistence
  5. Pytanie$onAction w Pinia
  6. Ułóż w kolejnościPrzepływ $subscribe
  7. PytanieCustom plugin
  8. Zadanie z kodemPraktyka: Kompletny system logowania
  9. Kliknij w kolejnościPlugin pattern
  10. Ułóż w kolejnościPersist konfiguracja zaawansowana
  11. Ułóż w kolejnościDostęp do state w store
  12. PytanieDevTools w Pinia
  13. Ułóż w kolejnościPrzepływ danych w Pinia
  14. PytanieVuex vs Pinia - mutations
  15. Ułóż w kolejności$patch z funkcją
  16. Kliknij w kolejnościPełny lifecycle store
  17. Ułóż w kolejnościKiedy użyć Pinia vs provide/inject?
  18. Ułóż w kolejnościRejestracja pluginu Pinia

Przydatne artykuły