Kurs Vue.js · Moduł 1: Vue i Vite

Projekt: Panel Kontrolny NOVA LAB

4 min czytania ·
W tej lekcji5

Gratulacje, kadetcie! Dotarliśmy do finalnego projektu pierwszego modułu na stacji NOVA LAB. Czas połączyć wszystkie poznane umiejętności w jeden funkcjonalny system.

Każdy moduł stacji ma dziś własny ekran, a dyżurny inżynier biega między nimi, żeby sprawdzić, czy wszystko działa. Potrzebny jest jeden panel, który zbierze stan całej stacji w jednym miejscu - i właśnie taki panel zbudujesz.

Cel projektu

Zbuduj kompletny Panel Kontrolny NOVA LAB - aplikację Vue.js, która łączy wszystkie koncepty z tego modułu:

  • Vue.js i Vite - nowoczesny framework reaktywny
  • Single File Components - organizacja kodu w plikach .vue
  • Struktura aplikacji - poprawna hierarchia komponentów
  • Vue DevTools - narzędzia diagnostyczne do debugowania

Wymagania projektu

Twój Panel Kontrolny powinien zawierać:

1. Sekcja statusu stacji

Wyświetl nazwę stacji, aktualny status (ONLINE/OFFLINE) oraz datę ostatniej aktualizacji. Użyj interpolacji Vue do wyświetlania danych.

2. Lista modułów stacji

Stwórz tablicę z minimum 4 modułami stacji (np. Laboratorium, Reaktor, Komunikacja, Nawigacja). Każdy moduł powinien mieć nazwę, status i poziom energii.

3. Stylowanie komponentu

Użyj sekcji <style scoped> aby nadać aplikacji wygląd panelu kosmicznego - ciemne tło, neonowe kolory, futurystyczny design.

Co Czeka w Starterze

Starter w edytorze ma już dane i szkielet szablonu. Proste wartości, takie jak nazwa stacji, trzymają kontenery ref(), a tablicę modułów obejmuje nowa funkcja reactive(). Działa podobnie, ale przyjmuje obiekt lub tablicę i sprawia, że reaktywne są wszystkie ich pola, a do elementów sięgasz bez .value:

import { ref, reactive } from 'vue'

const stationName = ref('NOVA LAB')

const modules = reactive([
  { id: 1, name: 'Laboratorium', status: 'active', energy: 85 },
  { id: 2, name: 'Reaktor', status: 'active', energy: 92 }
  // ...i kolejne moduły ze startera
])

Gdy zmienisz modules[0].energy, pasek na ekranie przesunie się sam, a tablica pozostaje zwykłą tablicą z tymi samymi metodami. Szczegóły reactive() poznasz w Reaktorze Energetycznym.

Karty modułów powstają dzięki dyrektywie v-for, która powtarza element dla każdego elementu tablicy. Atrybut :key nadaje każdej kopii unikalny identyfikator, a :style ustawia szerokość paska energii, tak jak :class ustawia klasę:

<div v-for="mod in modules" :key="mod.id" class="module-card">
  <h3>{{ mod.name }}</h3>
  <div class="energy-bar">
    <div class="energy-fill" :style="{ width: mod.energy + '%' }"></div>
  </div>
</div>

Vue wstawi tyle kart, ile elementów ma tablica, więc piąty moduł dopisany do danych od razu doda piątą kartę, bez zmian w szablonie. Renderowanie list omówimy dokładnie w Pracowni Hologramów.

Rozbudowa Panelu

Na tym starter się kończy. Rozbuduj go o narzędzia, które poznałeś w Strefie Startowej:

  • przycisk z @click, który przełącza status stacji między ONLINE i OFFLINE,
  • wartość computed ze średnim poziomem energii wszystkich modułów,
  • klasę zależną od statusu modułu, nadaną przez :class,
  • komunikat v-if i v-else, gdy energia któregoś modułu spadnie poniżej 50%,
  • watch, który zapisze w konsoli każdą zmianę statusu stacji.

Pierwszy punkt możesz zacząć od takiej funkcji. Korzysta ona z operatora warunkowego: gdy stacja jest ONLINE, przełącza ją na OFFLINE, i odwrotnie:

function toggleStation() {
  stationStatus.value = stationStatus.value === 'ONLINE' ? 'OFFLINE' : 'ONLINE'
}

Podepnij ją pod przycisk zapisem @click="toggleStation", a napis w nagłówku zmieni się przy każdym kliknięciu. Polecam budować panel krok po kroku: po każdej zmianie zerknij na podgląd i na zakładkę Components w DevTools, zamiast pisać wszystko naraz.

Wskazówki

  • Zacznij od sekcji <script setup> z danymi reaktywnymi
  • Użyj ref() dla prostych wartości i reactive() dla obiektów
  • Pamiętaj o sekcji <template> z poprawną składnią Vue
  • Dodaj <style scoped> na końcu komponentu

Starter stawia <script setup> na samej górze pliku. To również poprawna kolejność: Vue jej nie narzuca, a przewodnik stylu zaleca tylko, żeby w całym projekcie była spójna, a styl stał na końcu. Gotowy panel wyślesz mentorowi w kolejnym zadaniu, więc opisz w nim, gdzie użyłeś ref(), dyrektyw, computed i watch.

Eksperymentuj z kodem poniżej i rozbuduj go o własne pomysły!

Zapamiętaj: panel kontrolny to wszystkie narzędzia Strefy Startowej w jednym module - dane w kontenerach, szablon, który je pokazuje, i style zamykające całość w obudowie.

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

// Panel Kontrolny NOVA LAB - projekt końcowy modułu 1
const stationName = ref('NOVA LAB')
const stationStatus = ref('ONLINE')
const lastUpdate = ref(new Date().toLocaleString())

const modules = reactive([
  { id: 1, name: 'Laboratorium', status: 'active', energy: 85 },
  { id: 2, name: 'Reaktor', status: 'active', energy: 92 },
  { id: 3, name: 'Komunikacja', status: 'warning', energy: 45 },
  { id: 4, name: 'Nawigacja', status: 'active', energy: 78 }
])

// TODO: Dodaj więcej modułów stacji
// TODO: Dodaj funkcje przełączania statusu
// TODO: Dodaj obliczanie średniej energii
</script>

<template>
  <div class="control-panel">
    <header>
      <h1>{{ stationName }} - Panel Kontrolny</h1>
      <p>Status: {{ stationStatus }} | Ostatnia aktualizacja: {{ lastUpdate }}</p>
    </header>

    <section class="modules">
      <h2>Moduły stacji</h2>
      <!-- TODO: Wyświetl listę modułów z v-for -->
      <!-- TODO: Dodaj dynamiczne klasy na podstawie statusu -->
      <div v-for="mod in modules" :key="mod.id" class="module-card">
        <h3>{{ mod.name }}</h3>
        <p>Status: {{ mod.status }}</p>
        <div class="energy-bar">
          <div class="energy-fill" :style="{ width: mod.energy + '%' }"></div>
        </div>
        <span>{{ mod.energy }}%</span>
      </div>
    </section>
  </div>
</template>

<style scoped>
.control-panel {
  background: #0a0a2e;
  color: #e0e0ff;
  min-height: 100vh;
  padding: 2rem;
  font-family: 'Courier New', monospace;
}
header { text-align: center; border-bottom: 1px solid #333; padding-bottom: 1rem; }
h1 { color: #00d4ff; }
.modules { display: flex; flex-wrap: wrap; gap: 1rem; margin-top: 1rem; }
.module-card { background: #1a1a4e; padding: 1rem; border-radius: 8px; flex: 1; min-width: 200px; border: 1px solid #333; }
.energy-bar { background: #222; border-radius: 4px; height: 8px; margin: 0.5rem 0; }
.energy-fill { background: #00d4ff; height: 100%; border-radius: 4px; transition: width 0.3s; }
</style>

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

  1. Projekt do wysłaniaLink do mentora: Projekt Vue + Vite
  2. WideoPodsumowanie modułu

Przydatne artykuły