Kurs Vue.js · Moduł 11: Pinia

State w Pinia

2 min czytania ·
W tej lekcji5

State to reaktywne dane przechowywane w store - jak baza danych głównego komputera NOVA LAB. Każdy odczyt sensora, każdy parametr misji jest tu zapisany i dostępny dla wszystkich modułów stacji.

Definiowanie state

W Composition API style state to zwykłe ref() i reactive():

import { defineStore } from 'pinia'
import { ref, reactive } from 'vue'

export const useResourceStore = defineStore('resources', () => {
  // Proste wartości - ref()
  const oxygen = ref(98.5)
  const water = ref(1250)
  const energy = ref(87)
  const isEmergency = ref(false)

  // Obiekty - reactive() lub ref()
  const crew = reactive({
    commander: 'Nova',
    engineer: 'Atlas',
    scientist: 'Darwin'
  })

  // Tablice
  const logs = ref([])

  return { oxygen, water, energy, isEmergency, crew, logs }
})

Modyfikacja state

State można modyfikować bezpośrednio w actions lub z komponentu:

export const useResourceStore = defineStore('resources', () => {
  const oxygen = ref(98.5)

  // Action modyfikuje state
  function consumeOxygen(amount) {
    oxygen.value = Math.max(0, oxygen.value - amount)
  }

  return { oxygen, consumeOxygen }
})
<script setup>
const store = useResourceStore()

// Bezpośrednia modyfikacja (działa, ale actions są lepsze)
store.oxygen = 95.0

// Przez action (zalecane)
store.consumeOxygen(3.5)
</script>

$patch - aktualizacja wielu właściwości

$patch pozwala zaktualizować wiele właściwości state jednocześnie - to bardziej wydajne niż modyfikacja po jednej:

const store = useResourceStore()

// Obiekt patch - proste nadpisanie
store.$patch({
  oxygen: 95.0,
  water: 1200,
  energy: 82,
  isEmergency: false
})

// Funkcja patch - dla złożonych operacji
store.$patch((state) => {
  state.oxygen -= 3.5
  state.logs.push({
    type: 'consumption',
    timestamp: Date.now()
  })
})

$reset - przywracanie stanu początkowego

W Options API style $reset() działa automatycznie. W Composition API musisz zdefiniować własną funkcję reset:

export const useResourceStore = defineStore('resources', () => {
  const oxygen = ref(100)
  const water = ref(1500)
  const energy = ref(100)

  // Custom reset dla Composition API
  function $reset() {
    oxygen.value = 100
    water.value = 1500
    energy.value = 100
  }

  return { oxygen, water, energy, $reset }
})

// Użycie
const store = useResourceStore()
store.$reset() // Przywraca wartości początkowe

$state - dostęp do całego stanu

const store = useResourceStore()

// Odczyt całego state
const snapshot = store.$state

// Nadpisanie całego state
store.$state = {
  oxygen: 100,
  water: 1500,
  energy: 100,
  isEmergency: false,
  crew: { commander: 'Nova' },
  logs: []
}
Kod do tej lekcji: App.vue
<script setup>
import { ref, computed } from 'vue'

// Symulacja store zasobów
const oxygen = ref(98.5)
const water = ref(1250)
const energy = ref(87)
const logs = ref([])

// Getters
const oxygenStatus = computed(() => oxygen.value > 50 ? 'OK' : 'LOW')
const waterStatus = computed(() => water.value > 500 ? 'OK' : 'LOW')
const energyStatus = computed(() => energy.value > 40 ? 'OK' : 'LOW')

// Actions
function consumeOxygen(amount) {
  oxygen.value = Math.max(0, +(oxygen.value - amount).toFixed(1))
  addLog('Zużyto tlen: -' + amount + '%')
}

function consumeWater(amount) {
  water.value = Math.max(0, water.value - amount)
  addLog('Zużyto wodę: -' + amount + ' L')
}

function consumeEnergy(amount) {
  energy.value = Math.max(0, energy.value - amount)
  addLog('Zużyto energię: -' + amount + '%')
}

function addLog(message) {
  logs.value.unshift({
    message,
    time: new Date().toLocaleTimeString()
  })
  if (logs.value.length > 8) logs.value.pop()
}

// Symulacja $patch
function patchResources(updates) {
  if (updates.oxygen !== undefined) oxygen.value = updates.oxygen
  if (updates.water !== undefined) water.value = updates.water
  if (updates.energy !== undefined) energy.value = updates.energy
  addLog('Zasoby zaktualizowane przez $patch')
}

function resetResources() {
  oxygen.value = 100
  water.value = 1500
  energy.value = 100
  logs.value = []
}
</script>

<template>
  <div class="nova-lab">
    <h1>NOVA LAB - zarządzanie stanem</h1>

    <div class="grid">
      <div class="resource-panel">
        <h2>Zasoby</h2>
        <div class="resource" v-for="r in [
          { name: 'Tlen', value: oxygen, unit: '%', status: oxygenStatus, action: () => consumeOxygen(5) },
          { name: 'Woda', value: water, unit: 'L', status: waterStatus, action: () => consumeWater(50) },
          { name: 'Energia', value: energy, unit: '%', status: energyStatus, action: () => consumeEnergy(10) }
        ]" :key="r.name">
          <div class="r-header">
            <span>{{ r.name }}</span>
            <span :class="r.status.toLowerCase()">{{ r.status }}</span>
          </div>
          <div class="r-value">{{ r.value }}{{ r.unit }}</div>
          <button @click="r.action" class="btn-sm">Zużyj</button>
        </div>

        <div class="btn-group">
          <button @click="patchResources({ oxygen: 50, water: 800 })" class="btn">
            $patch (O2=50, H2O=800)
          </button>
          <button @click="resetResources" class="btn btn-reset">
            $reset
          </button>
        </div>
      </div>

      <div class="log-panel">
        <h2>Dziennik aktywności</h2>
        <div v-for="(log, i) in logs" :key="i" class="log-entry">
          <span class="log-time">{{ log.time }}</span>
          {{ log.message }}
        </div>
        <p v-if="!logs.length" class="empty">Brak aktywności...</p>
      </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; }
h2 { color: #00b4d8; margin-bottom: 15px; }
.grid { display: grid; grid-template-columns: 1fr 1fr; gap: 15px; max-width: 700px; margin: 0 auto; }
.resource-panel, .log-panel {
  background: rgba(0, 180, 216, 0.1);
  border: 2px solid #00b4d8;
  padding: 15px;
}
.resource {
  background: rgba(0, 255, 136, 0.05);
  border: 1px solid #00ff88;
  padding: 10px;
  margin-bottom: 8px;
}
.r-header { display: flex; justify-content: space-between; margin-bottom: 5px; }
.r-value { font-size: 1.2em; font-weight: bold; margin-bottom: 5px; }
.ok { color: #00ff88; }
.low { color: #ff4444; }
.btn-sm {
  background: #00b4d8;
  color: #0a0e27;
  border: none;
  padding: 4px 12px;
  cursor: pointer;
  font-family: monospace;
}
.btn-group { display: flex; gap: 8px; margin-top: 10px; flex-wrap: wrap; }
.btn {
  background: #00b4d8;
  color: #0a0e27;
  border: none;
  padding: 8px 12px;
  cursor: pointer;
  font-family: monospace;
  font-size: 0.85em;
}
.btn:hover { background: #00ff88; }
.btn-reset { background: #ff9900; }
.log-entry {
  padding: 5px 0;
  border-bottom: 1px solid rgba(0, 180, 216, 0.3);
  font-size: 0.85em;
}
.log-time { color: #00b4d8; margin-right: 8px; }
.empty { color: #666; font-style: italic; }
</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. Jak zdefiniować state w Composition API style?

  2. 2. Do czego służy $patch() w Pinia?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Stwórz store z ref() state, action consumeOxygen i action patchResources.

  • Układanie w pionie

    Ułóż kroki konfiguracji Pinia w main.js:

  • Klikanie w kolejności

    Ułóż kod destrukturyzacji store z zachowaniem reaktywności:

  • Edytor kodu

    Stwórz patchUpdate (ustawia wartości) i patchFunction (zmniejsza o 10%).

  1. PytanieDefiniowanie state
  2. PytanieMetoda $patch
  3. Zadanie z kodemPraktyka: State i $patch
  4. Ułóż w kolejnościKonfiguracja Pinia
  5. PytaniestoreToRefs
  6. Kliknij w kolejnościUżycie storeToRefs
  7. Zadanie z kodemPraktyka: $patch z funkcją

Przydatne artykuły