Kurs Vue.js · Moduł 13: Przejścia i animacje
Transition między routami
W tej lekcji5
W NOVA LAB przechodzenie między sekcjami stacji - z centrum dowodzenia do laboratorium, z reaktora do hangaru - powinno być płynne i naturalne. Vue Router wspiera animacje przejść między stronami dzięki integracji z komponentem <Transition>.
RouterView + Transition
Aby animować zmianę widoku routera, używasz slot API na <RouterView>. Vue Router udostępnia aktualny komponent jako zmienną slotową:
<RouterView v-slot="{ Component }">
<Transition name="page" mode="out-in">
<component :is="Component" />
</Transition>
</RouterView>Jak to działa krok po kroku:
<RouterView v-slot="{ Component }">- router dostarcza aktualny komponent strony jakoComponent<Transition name="page" mode="out-in">- opakowujesz dynamiczny komponent w Transition<component :is="Component" />- renderujesz dynamiczny komponent strony
Trzy kluczowe zasady:
- Użyj
v-slot="{ Component }"- nie możesz bezpośrednio owinąć<RouterView>w<Transition>(to nie zadziała w Vue 3) - Zawsze dodaj
mode="out-in"- bez tego stara i nowa strona będą animowane jednocześnie, co wygląda chaotycznie - Nie dodawaj
:keyna<component>- Vue Router automatycznie reaguje na zmianę routy
Odpowiednie klasy CSS:
.page-enter-active,
.page-leave-active {
transition: all 0.3s ease;
}
.page-enter-from {
opacity: 0;
transform: translateX(20px);
}
.page-leave-to {
opacity: 0;
transform: translateX(-20px);
}Per-route transitions
Każda sekcja stacji NOVA LAB może mieć inny typ animacji - centrum dowodzenia wsuwa się z lewej, panel alertów wyskakuje z dołu. Użyj pola meta w definicji routy, aby przypisać nazwę animacji:
const routes = [
{
path: '/dashboard',
component: Dashboard,
meta: { transition: 'slide-left' }
},
{
path: '/settings',
component: Settings,
meta: { transition: 'slide-right' }
},
{
path: '/alerts',
component: Alerts,
meta: { transition: 'slide-up' }
}
]W template odczytaj nazwę animacji z obiektu route:
<RouterView v-slot="{ Component, route }">
<Transition :name="route.meta.transition || 'fade'" mode="out-in">
<component :is="Component" />
</Transition>
</RouterView>Zwróć uwagę na || 'fade' - to fallback dla routów bez zdefiniowanej animacji. Slot v-slot daje dostęp zarówno do Component (aktualny komponent strony) jak i route (obiekt routy z meta danymi).
Dynamiczne animacje na podstawie kierunku nawigacji
Możesz zmieniać animację w zależności od tego, czy użytkownik nawiguje "w przód" czy "w tył":
<script setup>
import { ref } from 'vue'
import { useRouter } from 'vue-router'
const transitionName = ref('slide-left')
const router = useRouter()
router.beforeEach((to, from) => {
// Porównaj indeksy stron aby określić kierunek
const toDepth = to.path.split('/').length
const fromDepth = from.path.split('/').length
transitionName.value = toDepth < fromDepth ? 'slide-right' : 'slide-left'
})
</script>
<template>
<RouterView v-slot="{ Component }">
<Transition :name="transitionName" mode="out-in">
<component :is="Component" />
</Transition>
</RouterView>
</template>Z KeepAlive
Możesz łączyć Transition z KeepAlive, aby cache'ować widoki stron. To przydatne gdy użytkownik często przechodzi między tymi samymi sekcjami stacji i nie chcesz tracić stanu (np. pozycji scrolla, wprowadzonych danych):
<RouterView v-slot="{ Component }">
<Transition name="fade" mode="out-in">
<KeepAlive :max="5">
<component :is="Component" />
</KeepAlive>
</Transition>
</RouterView>Kolejność jest istotna - <Transition> na zewnątrz, <KeepAlive> wewnątrz. Atrybut :max="5" ogranicza liczbę cache'owanych komponentów, aby nie zużywać nadmiernej ilości pamięci.
Uwagi praktyczne
- Animacje przejść między stronami powinny być krótkie (200-400ms) - użytkownik chce szybko zobaczyć treść
- Unikaj ciężkich animacji (np. 3D transforms) na urządzeniach mobilnych
- Testuj animacje na wolniejszych urządzeniach - efekt, który wygląda świetnie na szybkim komputerze, może lagować na tablecie
- Preferuj
opacityitransform- te właściwości są akcelerowane przez GPU
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
// Symulacja routera z komponentami
const currentRoute = ref('home')
const routes = {
home: { name: 'Panel główny', icon: '' },
sensors: { name: 'Czujniki', icon: '' },
crew: { name: 'Załoga', icon: '' }
}
</script>
<template>
<div class="nova-lab">
<h1>Transition między routami</h1>
<p style="color: #888;">Symulacja Transition z RouterView</p>
<nav class="nav">
<button
v-for="(route, key) in routes"
:key="key"
@click="currentRoute = key"
:class="{ active: currentRoute === key }"
class="nav-link"
>
{{ route.icon }} {{ route.name }}
</button>
</nav>
<!-- Symulacja: RouterView v-slot + Transition -->
<Transition name="page" mode="out-in">
<div :key="currentRoute" class="page">
<h2>{{ routes[currentRoute].icon }} {{ routes[currentRoute].name }}</h2>
<p>Zawartość strony: {{ currentRoute }}</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: 8px;
margin: 15px 0;
border-bottom: 2px solid #1a1e3a;
padding-bottom: 10px;
}
.nav-link {
background: transparent;
color: #00b4d8;
border: 1px solid transparent;
padding: 8px 16px;
border-radius: 6px 6px 0 0;
cursor: pointer;
}
.nav-link.active {
background: rgba(0, 180, 216, 0.15);
border-color: #00b4d8;
border-bottom-color: transparent;
}
.page {
background: rgba(0, 255, 136, 0.05);
border: 2px solid #00ff88;
padding: 30px;
border-radius: 0 12px 12px 12px;
min-height: 150px;
}
/* Przejście strony */
.page-enter-active,
.page-leave-active {
transition: all 0.3s ease;
}
.page-enter-from {
opacity: 0;
transform: translateY(20px);
}
.page-leave-to {
opacity: 0;
transform: translateY(-20px);
}
</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. Jak dodać animację przejścia między stronami w Vue Router?
2. Jak zdefiniować nazwę animacji per-route w Vue Router?
Zadania praktyczne w grze
- Układanie w pionie
Ułóż zagnieżdżenie komponentów dla animacji routingu:
- Edytor kodu
Owiń RouterView v-slot w <Transition> z mode='out-in'.
- Układanie w poziomie
Ułóż składnię RouterView z v-slot:
- Klikanie w kolejności
Ułóż kod dynamicznej nazwy transition per-route: