Kurs Vue.js · Moduł 8: Sloty i komponenty dynamiczne

Projekt: System Magazynu NOVA LAB

4 min czytania ·
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, default i footer,
  • 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ą:

  1. StationDashboard - komponent z named slots (header, default, footer) tworzący layout,
  2. CargoList - lista modułów cargo, która przy uszkodzonym module emituje alert,
  3. Dynamic components - <component :is> przełącza między CargoList, AddModule i StationLog,
  4. KeepAlive - zachowuje stan AddModule po przełączeniu tabów,
  5. 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:

  1. W CargoList opakuj 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.
  2. Zamień import StationLog na defineAsyncComponent, żeby dziennik ładował się dopiero przy pierwszym otwarciu.
  3. Dodaj do KeepAlive atrybut :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?

  1. Projekt do wysłaniaLink do mentora: Slots & Dynamic Components
  2. WideoPodsumowanie modułu

Przydatne artykuły