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

Transition między routami

3 min czytania ·
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:

  1. <RouterView v-slot="{ Component }"> - router dostarcza aktualny komponent strony jako Component
  2. <Transition name="page" mode="out-in"> - opakowujesz dynamiczny komponent w Transition
  3. <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 :key na <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 opacity i transform - 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. 1. Jak dodać animację przejścia między stronami w Vue Router?

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

  1. PytanieTransition z RouterView
  2. Ułóż w kolejnościKolejność komponentów router transition
  3. Zadanie z kodemPraktyka: Router Transition
  4. Ułóż w kolejnościRouterView v-slot składnia
  5. Kliknij w kolejnościPer-route transition
  6. PytanieMeta field transition

Przydatne artykuły