Kurs Vue.js · Moduł 1: Vue i Vite
Projekt: Panel Kontrolny NOVA LAB
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ść
computedze średnim poziomem energii wszystkich modułów, - klasę zależną od statusu modułu, nadaną przez
:class, - komunikat
v-ifiv-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 ireactive()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?