Kurs Vue.js · Moduł 13: Przejścia i animacje

Named Transitions i tryby przejść

5 min czytania ·
W tej lekcji4

W NOVA LAB mamy wiele paneli - panel diagnostyczny reaktora wsuwa się z boku, panel alertów pojawia się z efektem fade, a panel nawigacji zjeżdża z góry. Vue pozwala nazywać Transition, co zmienia prefiksy klas CSS i umożliwia definiowanie wielu różnych animacji w jednej aplikacji.

W poprzedniej lekcji każda animacja korzystała z klas z prefiksem v-. To działa, dopóki animacja jest jedna. Gdy dodasz drugą, reguły dla v-enter-from i v-leave-to zaczną obowiązywać oba panele naraz, więc reaktor zamiast wsuwać się z boku zacznie przenikać jak alert. Drugi kłopot pojawia się przy podmianie paneli: stary jeszcze wychodzi, a nowy już wchodzi, więc przez chwilę oba zajmują miejsce i układ skacze. W tej lekcji usuniesz obie usterki Sali Holograficznej za pomocą dwóch atrybutów.

Named Transitions

Domyślnie <Transition> używa prefiksu v- dla klas CSS. Atrybut name zmienia ten prefiks na wybraną nazwę:

<Transition name="slide">
  <div v-if="visible">...</div>
</Transition>

Teraz klasy to: slide-enter-from, slide-enter-active, slide-enter-to, slide-leave-from, slide-leave-active, slide-leave-to. Nazwa sama nie dodaje żadnego efektu - zmienia tylko nazwy klas, a wygląd animacji nadal opisujesz w CSS:

.slide-enter-active,
.slide-leave-active {
  transition: all 0.3s ease;
}
.slide-enter-from {
  opacity: 0;
  transform: translateX(30px);
}
.slide-leave-to {
  opacity: 0;
  transform: translateX(-30px);
}

Klasy z końcówką -active określają, jak długo i z jaką krzywą trwa przejście, a enter-from i leave-to mówią, skąd element przylatuje i dokąd odlatuje. Ten panel wjeżdża z prawej, a wyjeżdża w lewo.

Dzięki named transitions możesz mieć jednocześnie wiele typów animacji:

<template>
  <!-- Panel reaktora - wsuwa się z prawej -->
  <Transition name="slide-right">
    <div v-if="showReactor">Reactor Panel</div>
  </Transition>

  <!-- Alert - pojawia się z efektem fade -->
  <Transition name="fade">
    <div v-if="showAlert">Alert!</div>
  </Transition>

  <!-- Menu - zjeżdża z góry -->
  <Transition name="slide-down">
    <nav v-if="showMenu">Navigation</nav>
  </Transition>
</template>

Każdy <Transition> szuka wyłącznie klas ze swoim prefiksem, więc style trzech paneli nie wchodzą sobie w drogę:

/* Fade */
.fade-enter-active, .fade-leave-active { transition: opacity 0.3s; }
.fade-enter-from, .fade-leave-to { opacity: 0; }

/* Slide z prawej */
.slide-right-enter-active, .slide-right-leave-active { transition: all 0.4s ease; }
.slide-right-enter-from { transform: translateX(100%); opacity: 0; }
.slide-right-leave-to { transform: translateX(100%); opacity: 0; }

/* Slide z góry */
.slide-down-enter-active, .slide-down-leave-active { transition: all 0.3s ease; }
.slide-down-enter-from { transform: translateY(-100%); opacity: 0; }
.slide-down-leave-to { transform: translateY(-100%); opacity: 0; }

Zwróć uwagę, że szablon różni się tylko wartością atrybutu name - cała różnica między wsuwaniem, przenikaniem i zjeżdżaniem siedzi w arkuszu stylów.

Tryby przejść (mode)

Gdy przełączasz się między dwoma elementami w jednym <Transition>, domyślnie oba animują się jednocześnie - stary wychodzi, a nowy wchodzi w tym samym czasie. To często wygląda chaotycznie. Atrybut mode kontroluje kolejność:

  • mode="out-in" - stary element wychodzi i dopiero po zakończeniu jego animacji nowy wchodzi. To najczęściej używany tryb - zapobiega "skakaniu" layoutu.
  • mode="in-out" - nowy element wchodzi, a stary wychodzi dopiero potem. Rzadko używany, ale przydatny np. do efektu nakładania się.
  • Brak mode - oba elementy animują się jednocześnie. Może powodować problemy z layoutem.

Tak wygląda przełącznik widoków centrum dowodzenia z trybem out-in:

<template>
  <div class="view-switcher">
    <button @click="currentView = currentView === 'status' ? 'alerts' : 'status'">
      Switch View
    </button>

    <Transition name="fade" mode="out-in">
      <div v-if="currentView === 'status'" key="status" class="panel">
        System Status: All nominal
      </div>
      <div v-else key="alerts" class="panel">
        Active Alerts: 3
      </div>
    </Transition>
  </div>
</template>

<script setup>
import { ref } from 'vue'

const currentView = ref('status')
</script>

Po kliknięciu panel statusu najpierw całkowicie znika, a dopiero potem pojawia się panel alertów, więc w żadnym momencie nie ma na ekranie dwóch paneli naraz.

Ważne: W Vue 3 gałęzie v-if i v-else dostają unikalne klucze automatycznie, więc przełączanie dwóch <div> zadziała także bez atrybutu key - jawny key, jak w przykładzie, nie szkodzi i dobrze opisuje intencję. Klucz staje się niezbędny wtedy, gdy ten sam element zostaje na miejscu, a zmienia się tylko jego treść, na przykład <span :key="count">{{ count }}</span>. Bez :key Vue podmieniłoby sam tekst w istniejącym elemencie i przejście w ogóle by się nie uruchomiło.

Przełączanie komponentów

mode="out-in" świetnie działa z dynamicznymi komponentami. Element <component :is> renderuje komponent wskazany w zmiennej, a shallowRef przechowuje go bez głębokiej reaktywności, bo liczy się tylko podmiana całego komponentu:

<template>
  <Transition name="slide" mode="out-in">
    <component :is="currentTab" />
  </Transition>
</template>

<script setup>
import { shallowRef } from 'vue'
import StatusPanel from './StatusPanel.vue'
import AlertsPanel from './AlertsPanel.vue'

const currentTab = shallowRef(StatusPanel)
</script>

Przy każdej zmianie currentTab Vue najpierw odegra wyjście starego panelu, a dopiero potem wejście nowego. StatusPanel i AlertsPanel to dwie różne definicje komponentów, więc animacja rusza bez dodatkowego klucza.

Praktyczna wskazówka

Dla prostych przełączeń między widokami, mode="out-in" z animacją fade to najbardziej eleganckie rozwiązanie. Unikaj mode="in-out" chyba że masz konkretny powód (np. nakładający się efekt slide). Brak mode sprawdza się głównie gdy oba elementy mają position: absolute i nie wpływają na layout.

Moja rada: nazywaj przejścia od ruchu, a nie od miejsca użycia - slide-right i fade przydadzą się w dziesięciu panelach, a reactor-animation tylko w jednym. Ta sama para name i mode wróci w lekcji o przejściach między trasami, gdzie owiniesz nią cały <RouterView>.

Zapamiętaj: name nadaje animacji własny zestaw klas, a mode ustala kolejkę - najpierw jeden panel znika, dopiero potem pojawia się drugi.

Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'

const currentView = ref('panel')
const views = ['panel', 'czujniki', 'załoga']
</script>

<template>
  <div class="nova-lab">
    <h1>Named Transitions i tryby przejść</h1>

    <div class="nav">
      <button
        v-for="view in views"
        :key="view"
        @click="currentView = view"
        :class="{ active: currentView === view }"
        class="nav-btn"
      >
        {{ view }}
      </button>
    </div>

    <!-- Transition z nazwanymi klasami i trybem out-in -->
    <Transition name="slide" mode="out-in">
      <div :key="currentView" class="panel">
        <h2>{{ currentView.toUpperCase() }}</h2>
        <p v-if="currentView === 'panel'">Panel główny stacji NOVA LAB</p>
        <p v-else-if="currentView === 'czujniki'">Odczyty czujników atmosferycznych</p>
        <p v-else>Lista członków załogi</p>
      </div>
    </Transition>
  </div>
</template>

<style scoped>
.nova-lab {
  background: #0a0e27;
  color: #00ff88;
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
h1 { color: #00ff88; }

.nav { display: flex; gap: 10px; margin: 15px 0; }
.nav-btn {
  background: rgba(0, 180, 216, 0.2);
  color: #00b4d8;
  border: 1px solid #00b4d8;
  padding: 8px 16px;
  border-radius: 6px;
  cursor: pointer;
}
.nav-btn.active {
  background: #00b4d8;
  color: white;
}

.panel {
  background: rgba(0, 255, 136, 0.05);
  border: 2px solid #00ff88;
  padding: 20px;
  border-radius: 12px;
}

/* klasy slide- (name="slide") */
.slide-enter-active,
.slide-leave-active {
  transition: all 0.3s ease;
}
.slide-enter-from {
  opacity: 0;
  transform: translateX(30px);
}
.slide-leave-to {
  opacity: 0;
  transform: translateX(-30px);
}
</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 powoduje dodanie atrybutu name='slide' do <Transition>?

  2. 2. Co robi tryb mode='out-in' w <Transition>?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Dodaj <Transition name='slide'> i odpowiednie klasy CSS slide-*.

  • Układanie w poziomie

    Ułóż poprawną składnię Transition z trybem out-in:

  • Układanie w pionie

    Ułóż kolejność klas CSS podczas animacji wyjścia elementu:

  • Edytor kodu

    Użyj <Transition mode='out-in'> do płynnego przełączania między komponentami.

  1. PytanieAtrybut name w Transition
  2. PytanieTryb przejścia out-in
  3. Zadanie z kodemPraktyka: Named Transition
  4. Ułóż w kolejnościSkładnia Transition z mode
  5. PytanieDomyślny tryb przejścia
  6. Ułóż w kolejnościKolejność klas Transition wyjścia
  7. Zadanie z kodemPraktyka: Tryby przejść

Przydatne artykuły