Kurs Vue.js · Moduł 11: Pinia

Composition API Stores (setup syntax)

3 min czytania ·
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?

AspektComposition APIOptions API
ElastycznośćPełnaOgraniczona
TypeScriptNaturalne typowanieWymaga deklaracji
$reset()Trzeba zdefiniować ręcznieDziała automatycznie
ComposablesŁatwe do użyciaTrudniejsze
SkładniaJak <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. 1. Jaki styl definiowania store zaleca Pinia?

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

  1. PytanieComposition vs Options API
  2. Ułóż w kolejnościElementy store w Composition API
  3. Zadanie z kodemPraktyka: Settings store
  4. PytanieWatchers w store
  5. Ułóż w kolejnościTypeScript w store
  6. Pytanie$reset w Composition API
  7. Zadanie z kodemPraktyka: Crew store kompletny

Przydatne artykuły