Kurs Vue.js · Moduł 3: Reaktywność

Projekt: Reaktywny Panel Kontrolny NOVA LAB

3 min czytania ·
W tej lekcji2

Finalny projekt modułu Reaktora Energetycznego! Połącz wszystkie techniki reaktywności Vue.js w jednym systemie monitorowania. Zbudujesz kompletny dashboard reaktora plazmowego, który w czasie rzeczywistym śledzi parametry, generuje alarmy i optymalizuje zużycie zasobów.

Wyobraź sobie nocną zmianę w sterowni: temperatura rdzenia rośnie, ciśnienie spada, a dyżurny inżynier ma tylko panel, który odświeża się wtedy, gdy ktoś sobie o tym przypomni. W tym projekcie budujesz panel, który nie potrzebuje przypominania - każdy odczyt, alarm i wpis historii trafia na ekran, bo tak ułożysz dane.

Podsumowanie modułu

W tym module poznałeś:

  • ref() - reaktywne zmienne prymitywne. Dostęp przez .value w skryptach, automatyczny unwrap w template. Idealne dla pojedynczych wartości jak temperatura, status, licznik.
  • reactive() - reaktywne obiekty i tablice. Bezpośredni dostęp do właściwości bez .value. Nie można zastąpić całego obiektu (tylko właściwości). Nie destructure bez toRefs!
  • Głęboka vs płytka reaktywność - shallowRef śledzi tylko podmianę .value, a shallowReactive tylko pierwszy poziom właściwości. triggerRef wymusza aktualizację po zmianie w miejscu. markRaw całkowicie wyłącza reaktywność. Przydatne dla dużych danych z API i bibliotek zewnętrznych.
  • toRef / toRefs - bezpieczna destrukturyzacja obiektów reaktywnych z zachowaniem reaktywności. toRef(obj, 'key') dla pojedynczej właściwości, toRefs(obj) dla wszystkich.
  • Narzędzia debugowania - isRef(), isReactive(), unref(), toRaw() do sprawdzania i rozpakowywania reaktywnych wartości.
  • Praktyczne wzorce - panele z walidacją, systemy filtrowania, koszyki zakupów z computed getters oraz readonly() do udostępniania stanu bez prawa zapisu.

Wymagania projektu

Zbuduj System Monitorowania Reaktora który zawiera:

1. Stan reaktora z reactive()

Stwórz obiekt reaktywny przechowujący dane reaktora: temperaturę (Kelvin), ciśnienie (kPa), poziom energii (%), status (ACTIVE/STANDBY/CRITICAL). Dodaj przyciski do modyfikowania wartości.

Starter trzyma temperaturę w stopniach Celsjusza i używa progów 400 i 500 - przestaw go na kelwiny i progi z wymagań poniżej. Przyciski niech wołają funkcje, które zmieniają właściwości obiektu. Samego obiektu nigdy nie podmieniaj, bo szablon straciłby z nim połączenie.

2. Alarmy z ref()

Użyj ref([]) do przechowywania listy alarmów systemowych. Gdy temperatura przekroczy 4000K lub ciśnienie spadnie poniżej 50kPa, automatycznie dodaj alarm do listy. Wyświetl alerty z możliwością usuwania.

Sprawdzaj progi w tych samych funkcjach, które zmieniają odczyty - tak robi już funkcja checkAlarms w starterze. Nadaj każdemu alarmowi własny identyfikator i użyj go jako :key zamiast indeksu, bo nowe alarmy trafiają na początek listy. Przed dodaniem sprawdź metodą some(), czy taki alarm już wisi, żeby każde kliknięcie nie dokładało duplikatu.

3. Bezpieczna destrukturyzacja z toRefs

Użyj toRefs aby wyodrębnić poszczególne wartości z obiektu reaktora. Wyświetl je w osobnych komponentach/sekcjach interfejsu bez utraty reaktywności.

Zmiana przez taki ref, na przykład temperature.value += 100, zmienia też reactor.temperature - to ten sam przewód, podłączony z dwóch stron.

4. Optymalizacja z markRaw

Stwórz tablicę historycznych odczytów i oznacz ją jako markRaw, aby nie obciążać systemu reaktywności. Wyświetl ostatnie 10 odczytów w panelu historii.

Tu czai się pułapka: tablicy oznaczonej markRaw Vue w ogóle nie obserwuje, więc samo push() nie odświeży panelu historii. Trzymaj ją w shallowRef i po dopisaniu odczytu wywołaj triggerRef, dokładnie jak w lekcji o płytkiej reaktywności:

const history = shallowRef(markRaw([]))

function recordReading(reading) {
  history.value.push(markRaw(reading))
  triggerRef(history)
}

Każdy odczyt zostaje zwykłym obiektem bez Proxy, a panel odświeża się raz na wpis. Ostatnie dziesięć pozycji pokażesz przez history.slice(-10) w szablonie, gdzie ref jest już rozpakowany.

Polecam zbudować projekt warstwami: najpierw dane, potem akcje, na końcu szablon, i sprawdzać każdą warstwę w Vue DevTools. W module 4, w Centrum Obliczeń, zastąpisz ręczne sprawdzanie progów właściwościami computed i watcherami.

Rozbuduj starter poniżej!

Zapamiętaj: panel kontrolny jest tak wiarygodny jak jego dane - trzymaj je w jednym miejscu, zmieniaj tylko akcjami i wybieraj reaktywność świadomie.

Kod do tej lekcji: App.vue
<script setup>
import { ref, reactive, toRefs, markRaw } from 'vue'

// System Monitorowania Reaktora - Projekt koncowy modulu 3
const reactor = reactive({
  name: 'Reaktor Alpha',
  temperature: 350,
  pressure: 101,
  energy: 85,
  status: 'NOMINAL'
})

const { temperature, pressure, energy, status } = toRefs(reactor)

const alarms = ref([])

// Logi historyczne - nie potrzebuja reaktywnosci
const historicalLogs = markRaw([
  { time: '08:00', event: 'System start' },
  { time: '08:15', event: 'Reactor online' },
  { time: '08:30', event: 'All systems nominal' }
])

function adjustTemperature(delta) {
  reactor.temperature += delta
  checkAlarms()
}

function adjustPressure(delta) {
  reactor.pressure += delta
  checkAlarms()
}

function checkAlarms() {
  if (reactor.temperature > 500) {
    alarms.value.unshift('KRYTYCZNE: Temperatura przekroczona!')
    reactor.status = 'CRITICAL'
  } else if (reactor.temperature > 400) {
    alarms.value.unshift('OSTRZEZENIE: Wysoka temperatura')
    reactor.status = 'WARNING'
  } else {
    reactor.status = 'NOMINAL'
  }
}

// TODO: Dodaj wiecej parametrow reaktora
// TODO: Dodaj automatyczne alarmy dla cisnienia
// TODO: Rozbuduj system logow
</script>

<template>
  <div class="reactor-monitor">
    <h1>System Monitorowania Reaktora</h1>
    <div class="status-bar" :class="status.toLowerCase()">
      Status: {{ status }}
    </div>

    <div class="panels">
      <div class="panel">
        <h3>Temperatura</h3>
        <p class="value">{{ temperature }}°C</p>
        <button @click="adjustTemperature(-10)">-10</button>
        <button @click="adjustTemperature(10)">+10</button>
      </div>
      <div class="panel">
        <h3>Cisnienie</h3>
        <p class="value">{{ pressure }} kPa</p>
        <button @click="adjustPressure(-5)">-5</button>
        <button @click="adjustPressure(5)">+5</button>
      </div>
      <div class="panel">
        <h3>Energia</h3>
        <p class="value">{{ energy }}%</p>
      </div>
    </div>

    <div class="alarms" v-if="alarms.length">
      <h3>Alarmy</h3>
      <p v-for="(alarm, i) in alarms" :key="i">{{ alarm }}</p>
    </div>
  </div>
</template>

<style scoped>
.reactor-monitor { background: #0a0a2e; color: #e0e0ff; padding: 2rem; min-height: 100vh; font-family: monospace; }
h1 { color: #ff6b35; text-align: center; }
.status-bar { text-align: center; padding: 0.5rem; border-radius: 4px; font-weight: bold; margin: 1rem 0; }
.status-bar.nominal { background: #1a4a1a; color: #00ff88; }
.status-bar.warning { background: #4a4a1a; color: #ffaa00; }
.status-bar.critical { background: #4a1a1a; color: #ff4444; }
.panels { display: flex; gap: 1rem; flex-wrap: wrap; }
.panel { background: #1a1a4e; padding: 1rem; border-radius: 8px; flex: 1; min-width: 150px; text-align: center; }
.value { font-size: 2rem; color: #00d4ff; margin: 0.5rem 0; }
button { background: #333; color: white; border: none; padding: 0.5rem 1rem; margin: 0.25rem; cursor: pointer; border-radius: 4px; }
button:hover { background: #555; }
.alarms { margin-top: 1rem; background: #2a1a1a; padding: 1rem; border-radius: 8px; }
.alarms h3 { color: #ff4444; }
.alarms p { color: #ffaa00; font-size: 0.9rem; }
</style>

Widzisz błąd w tej lekcji?

  1. Projekt do wysłaniaWyślij projekt: Panel kontrolny
  2. WideoPodsumowanie modułu

Przydatne artykuły