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

Teleport

4 min czytania ·
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. 1. Co robi komponent <KeepAlive> opakowujący dynamiczny komponent?

  2. 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.

  1. PytanieCel KeepAlive
  2. PytanieCel Teleport
  3. Zadanie z kodemPraktyka: KeepAlive
  4. Ułóż w kolejnościSkładnia KeepAlive
  5. Ułóż w kolejnościCykl życia Dynamic Component z KeepAlive
  6. PytanieAtrybut to w Teleport
  7. Kliknij w kolejnościKroki tworzenia modala z Teleport
  8. Zadanie z kodemPraktyka: Teleport modal

Przydatne artykuły