Kurs Vue.js · Moduł 11: Pinia

Podstawy Pinia

3 min czytania ·
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. 1. Czym jest Pinia w ekosystemie Vue 3?

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

  1. PytanieCzym jest Pinia?
  2. PytanieTworzenie instancji Pinia
  3. Zadanie z kodemPraktyka: Pierwszy store
  4. PytanieDefiniowanie store
  5. Kliknij w kolejnościSkładnia defineStore
  6. Zadanie z kodemPraktyka: Używanie store w komponencie

Przydatne artykuły