Kurs Vue.js · Moduł 13: Przejścia i animacje
Named Transitions i tryby przejść
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. Co powoduje dodanie atrybutu name='slide' do <Transition>?
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.