Kurs Vue.js · Moduł 8: Sloty i komponenty dynamiczne
Projekt: System Magazynu NOVA LAB
W tej lekcji4
Czas zastosować wszystkie wzorce magazynowe w jednym projekcie! Dr. Nova zleca Ci panel zarządzania cargo bay stacji. Wymagania brzmią prosto, ale każde z nich to inny mechanizm: panel ma pokazywać trzy widoki (listę modułów, formularz dodawania i dziennik), formularz nie może tracić wpisanych danych przy przełączaniu, a alarm o uszkodzonym module musi wyskoczyć ponad wszystkim innym. Każde z tych narzędzi znasz już osobno. W projekcie zobaczysz, jak współpracują.
Kod w edytorze wykorzystuje:
- Named Slots - elastyczny layout panelu cargo z sekcjami
header,defaultifooter, - Dynamic Components - przełączanie widoków stacji,
- KeepAlive - zachowanie stanu formularzy,
- Teleport - modal alertu krytycznego renderowany w
<body>, - własne zdarzenie
alert, które łączy listę cargo z modalem.
Scoped Slots do renderowania listy modułów i async components dołożysz sam w rozbudowie projektu.
Architektura
Zanim otworzysz pliki, obejrzyj drzewo komponentów. App.vue wypełnia sloty panelu StationDashboard, a w jego głównej sekcji podmienia widoki; modal alarmu wisi obok, poza panelem:
App
├── StationDashboard (named slots: header, default, footer)
│ ├── #header → Navigation tabs
│ ├── #default → <component :is> + KeepAlive
│ │ ├── CargoList (lista modułów, emituje alert)
│ │ ├── AddModule (formularz z lokalnym stanem)
│ │ └── StationLog (log zdarzeń)
│ └── #footer → pasek statusu stacji
└── Teleport → modal alertu (renderowany w body)StationDashboard nie wie nic o cargo: dostaje tylko nagłówek z zakładkami, główną treść i stopkę. Nagłówek i stopka są opakowane w v-if sprawdzający slots.header i slots.footer, a slot domyślny ma fallback "No panel selected".
Przepływ alarmu
Najciekawsza jest droga, jaką pokonuje alarm. Główna sekcja panelu to <component :is> opakowany w KeepAlive, z nasłuchem zdarzenia alert:
<template #default>
<KeepAlive>
<component
:is="currentTab"
@alert="triggerAlert"
/>
</KeepAlive>
</template>Nasłuch trafia do widoku, który jest akurat wyrenderowany. CargoList deklaruje zdarzenie przez defineEmits(['alert']) i emituje je, gdy klikniesz "Inspect" przy module ze statusem damaged. Funkcja triggerAlert w App.vue zapisuje komunikat w alertMsg i ustawia showAlert na true. Tę flagę czyta modal:
<Teleport to="body">
<div v-if="showAlert" class="modal-overlay" @click.self="showAlert = false">
<div class="modal">
<h3>STATION ALERT</h3>
<p>{{ alertMsg }}</p>
<button @click="showAlert = false">Dismiss</button>
</div>
</div>
</Teleport>Modal renderuje się w <body>, więc żadna ramka panelu go nie przytnie, a jego stan nadal należy do App.vue. Modyfikator .self sprawia, że kliknięcie w półprzezroczyste tło zamyka okno, a kliknięcie wewnątrz ramki alarmu - nie.
Zadanie
Przeanalizuj kod w edytorze i zrozum, jak wszystkie wzorce współpracują:
- StationDashboard - komponent z named slots (header, default, footer) tworzący layout,
- CargoList - lista modułów cargo, która przy uszkodzonym module emituje
alert, - Dynamic components -
<component :is>przełącza między CargoList, AddModule i StationLog, - KeepAlive - zachowuje stan AddModule po przełączeniu tabów,
- Teleport - modal alertu renderowany w body, wywoływany z dowolnego panelu.
Kluczowe obserwacje: named slots w StationDashboard dają elastyczny layout bez sztywnej struktury, KeepAlive zapobiega utracie danych formularza w AddModule, a Teleport zapewnia prawidłowe pozycjonowanie modala. Sprawdź to sam: wpisz nazwę modułu w formularzu, przejdź do dziennika i wróć - tekst wciąż tam będzie.
Rozbudowa
Gdy zrozumiesz gotowy kod, rozbuduj go o wzorce, których jeszcze w nim nie ma:
- W
CargoListopakuj znaczniki wiersza w<slot :item="item">, zostawiając obecny wygląd jako fallback. Wtedy scoped slot pozwoli rodzicowi zdecydować, jak renderować każdy moduł cargo. - Zamień import
StationLognadefineAsyncComponent, żeby dziennik ładował się dopiero przy pierwszym otwarciu. - Dodaj do
KeepAliveatrybut:include="['AddModule']"i sprawdź, że cache obejmuje teraz tylko formularz.
Moja rada: rozbudowuj projekt krok po kroku i po każdej zmianie przełączaj zakładki oraz wywołuj alarm, bo każdy z tych mechanizmów psuje się w inny sposób. Gotowy system wyślesz mentorowi w następnym zadaniu, razem z krótkim opisem architektury.
Zapamiętaj: dobry magazyn to zgrany zespół wzorców - sloty budują ramę, dynamic components wymieniają ładunek, KeepAlive pilnuje stanu, a Teleport wysyła alarm tam, gdzie zobaczy go cała załoga.
Kod do tej lekcji: App.vue
<script setup>
import { ref, shallowRef } from 'vue'
import StationDashboard from './StationDashboard.vue'
import CargoList from './CargoList.vue'
import AddModule from './AddModule.vue'
import StationLog from './StationLog.vue'
const tabs = [
{ name: 'Ładunek', component: CargoList },
{ name: 'Dodaj moduł', component: AddModule },
{ name: 'Dziennik', component: StationLog }
]
const currentTab = shallowRef(CargoList)
const showAlert = ref(false)
const alertMsg = ref('')
const triggerAlert = (msg) => {
alertMsg.value = msg
showAlert.value = true
}
</script>
<template>
<div class="nova-lab">
<StationDashboard>
<template #header>
<h1>System ładunków NOVA LAB</h1>
<nav class="tabs">
<button
v-for="tab in tabs"
:key="tab.name"
:class="{ active: currentTab === tab.component }"
@click="currentTab = tab.component"
>
{{ tab.name }}
</button>
</nav>
</template>
<template #default>
<KeepAlive>
<component
:is="currentTab"
@alert="triggerAlert"
/>
</KeepAlive>
</template>
<template #footer>
<p>NOVA LAB v2087.3 | Moduły: 4 | Status: sprawny</p>
</template>
</StationDashboard>
<Teleport to="body">
<div v-if="showAlert" class="modal-overlay" @click.self="showAlert = false">
<div class="modal">
<h3>ALARM STACJI</h3>
<p>{{ alertMsg }}</p>
<button @click="showAlert = false">Zamknij</button>
</div>
</div>
</Teleport>
</div>
</template>
<style scoped>
.nova-lab {
background: #0a0e27;
color: #00ff88;
min-height: 100vh;
padding: 20px;
font-family: monospace;
}
h1 { color: #00ff88; margin: 0; font-size: 18px; }
.tabs { display: flex; gap: 5px; margin-top: 10px; }
.tabs button {
background: rgba(0, 180, 216, 0.1);
border: 1px solid #00b4d8;
color: #00b4d8;
padding: 6px 14px;
cursor: pointer;
font-family: monospace;
}
.tabs button.active {
background: #00b4d8;
color: #0a0e27;
}
</style>
<style>
.modal-overlay {
position: fixed;
inset: 0;
background: rgba(0,0,0,0.8);
display: flex;
align-items: center;
justify-content: center;
z-index: 9999;
}
.modal {
background: #1a1a2e;
border: 3px solid #ff4444;
padding: 30px;
max-width: 400px;
text-align: center;
color: #00ff88;
font-family: monospace;
}
.modal h3 { color: #ff4444; margin-bottom: 15px; letter-spacing: 2px; }
.modal button {
margin-top: 15px;
background: #ff4444;
color: white;
border: none;
padding: 8px 20px;
cursor: pointer;
font-family: monospace;
}
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?