Kurs Vue.js · Moduł 8: Sloty i komponenty dynamiczne
Teleport
W tej lekcji6
W NOVA LAB system alarmowy wyświetla alert na głównym ekranie stacji, niezależnie od tego, który moduł go wywołał. Vue ma <Teleport> - mechanizm renderowania treści w innym miejscu DOM, poza hierarchią komponentu.
Problem
Modale, toasty i popupy logicznie należą do komponentu, ale wizualnie powinny być renderowane na najwyższym poziomie DOM (np. bezpośrednio w <body>), aby uniknąć problemów z z-index, overflow: hidden i pozycjonowaniem. Wyobraź sobie alarm tlenowy zagnieżdżony w panelu modułu, który ma overflow: hidden: modal zostanie przycięty do rozmiaru panelu. Jeśli któryś przodek ma właściwość transform, nawet position: fixed przestaje liczyć się względem okna przeglądarki. Przenoszenie modala do komponentu App.vue rozwiązałoby problem z CSS, ale rozerwałoby logikę: stan alarmu żyje przecież w module tlenu.
Podstawy Teleport
Teleport pozwala zostawić kod modala tam, gdzie jest jego logika, i jednocześnie wyrenderować jego HTML w innym miejscu. W poniższym panelu przycisk ustawia showModal, a cały modal jest opakowany w <Teleport to="body">:
<script setup>
import { ref } from 'vue'
const showModal = ref(false)
</script>
<template>
<div class="module-panel">
<h2>Oxygen Module</h2>
<button @click="showModal = true">Show Alert</button>
<Teleport to="body">
<div v-if="showModal" class="modal-overlay">
<div class="modal">
<h3>Critical Alert!</h3>
<p>Oxygen level below 20%</p>
<button @click="showModal = false">Dismiss</button>
</div>
</div>
</Teleport>
</div>
</template>Treść wewnątrz <Teleport> jest renderowana fizycznie w <body>, ale logicznie należy do komponentu - ma dostęp do jego danych i props. Zmienił się tylko adres w DOM: przekazywanie props, emitowanie zdarzeń i inject działają dokładnie tak jak wcześniej, a Vue Devtools nadal pokazują modal jako dziecko panelu.
Atrybut to
Atrybut to przyjmuje selektor CSS, a w razie potrzeby także gotowy element DOM. Najczęściej spotkasz trzy warianty:
<!-- Do body -->
<Teleport to="body">...</Teleport>
<!-- Do elementu z ID -->
<Teleport to="#modal-container">...</Teleport>
<!-- Do elementu z klasą -->
<Teleport to=".notifications">...</Teleport>Cel musi już istnieć w DOM w chwili montowania Teleportu. Najlepiej, gdy jest to element poza całą aplikacją Vue, na przykład <div id="modal-container"> dodany w index.html obok #app. Jeśli wskażesz selektor, którego nie ma, Vue wypisze ostrzeżenie, a treść się nie pojawi.
Deferred Teleport
Od Vue 3.5 Teleport ma atrybut defer. Dzięki niemu cel może być wyrenderowany przez tę samą aplikację nieco dalej w szablonie, bo Vue szuka go dopiero po zamontowaniu reszty drzewa:
<template>
<Teleport defer to="#station-log">
<p>Nowy wpis w dzienniku stacji</p>
</Teleport>
<!-- ten element renderuje się dopiero niżej w szablonie -->
<div id="station-log"></div>
</template>Bez defer ten sam kod szukałby #station-log, zanim element powstanie. Z defer cel musi się tylko pojawić w tym samym cyklu renderowania co Teleport.
Disabled Teleport
Możesz dynamicznie wyłączyć teleportację atrybutem disabled. Tutaj zmienna isMobile sprawia, że na telefonie popup renderuje się w miejscu, a na komputerze w <body>:
<script setup>
import { ref } from 'vue'
const isMobile = ref(false)
</script>
<template>
<!-- Na mobile renderuj lokalnie, na desktop w body -->
<Teleport to="body" :disabled="isMobile">
<div class="popup">
<p>Popup content</p>
</div>
</Teleport>
</template>Gdy disabled ma wartość true, treść renderuje się w oryginalnym miejscu w drzewie komponentów. Zmiana flagi w trakcie działania przenosi ten sam element tam i z powrotem, bez tworzenia go od nowa.
Wiele Teleportów do jednego celu
Możesz mieć kilka <Teleport> renderujących do tego samego elementu - treść jest dołączana w kolejności montowania, więc późniejsze trafiają za wcześniejsze:
<template>
<Teleport to="#notifications">
<div class="toast">Alert 1</div>
</Teleport>
<Teleport to="#notifications">
<div class="toast">Alert 2</div>
</Teleport>
</template>W kontenerze #notifications pojawi się najpierw "Alert 1", a pod nim "Alert 2". Żaden Teleport nie nadpisuje treści pozostałych, dlatego ten wzorzec świetnie nadaje się na stos powiadomień.
Moja rada: dodaj w index.html osobny kontener na modale obok #app i teleportuj tam wszystkie okna alarmowe. body też zadziała, ale własny kontener porządkuje warstwy strony. W projekcie na końcu modułu Teleport wyświetli alarm krytyczny wywołany z listy cargo. W edytorze poniżej moduł tlenu wywołuje taki alarm: modal ląduje w <body>, choć jego stan żyje w App.vue.
Zapamiętaj: Teleport przenosi ekran alarmowy tam, gdzie widać go najlepiej, ale sterowanie zostaje w module, który go wywołał.
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
const showModal = ref(false)
const alertMessage = ref('Krytyczny poziom tlenu: 15%')
</script>
<template>
<div class="nova-lab">
<h1>Demo: Teleport</h1>
<div class="module-panel">
<h2>Moduł tlenu</h2>
<p>Poziom: 15% - KRYTYCZNY</p>
<button @click="showModal = true" class="btn alert">
Pokaż alarm krytyczny
</button>
</div>
<div class="module-panel">
<h2>Moduł wody</h2>
<p>Poziom: 82% - w normie</p>
</div>
<!-- Modal przeniesiony przez Teleport do body -->
<Teleport to="body">
<div v-if="showModal" class="modal-overlay" @click.self="showModal = false">
<div class="modal">
<h3>ALARM KRYTYCZNY</h3>
<p>{{ alertMessage }}</p>
<p>Wymagana natychmiastowa reakcja!</p>
<button @click="showModal = false" class="btn">
Zamknij alarm
</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-bottom: 20px; }
.module-panel {
border: 2px solid #00b4d8;
padding: 15px;
margin: 10px 0;
background: rgba(0, 180, 216, 0.05);
}
.module-panel h2 { color: #00b4d8; margin-bottom: 8px; }
.btn {
background: #00b4d8;
color: #0a0e27;
border: none;
padding: 10px 20px;
cursor: pointer;
font-family: monospace;
font-weight: bold;
}
.btn.alert {
background: #ff4444;
color: white;
}
</style>
<style>
/* Style globalne dla modala przeniesionego przez Teleport */
.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;
font-size: 20px;
letter-spacing: 2px;
}
.modal p { margin: 8px 0; }
.modal button {
margin-top: 15px;
background: #ff4444;
color: white;
border: none;
padding: 10px 25px;
cursor: pointer;
font-family: monospace;
font-weight: bold;
}
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Co robi komponent <KeepAlive> opakowujący dynamiczny komponent?
2. Do czego służy <Teleport> w Vue?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Opakuj <component :is> w <KeepAlive> i sprawdź, że stan formularza jest zachowany po przełączeniu tabów.
- Układanie w poziomie
Ułóż składnię KeepAlive z dynamicznym komponentem:
- Układanie w pionie
Ułóż zdarzenia przy przełączaniu komponentu w <KeepAlive>:
- Klikanie w kolejności
Ułóż kroki implementacji modala z Teleport:
- Edytor kodu
Stwórz komponent AlertModal używający <Teleport to="body"> do renderowania modala poza hierarchią komponentu.