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

Integracja z bibliotekami animacji

3 min czytania ·
W tej lekcji5

NOVA LAB używa najnowszych technologii - hologramy, interfejsy 3D, dynamiczne panele kontrolne. Podobnie Ty możesz wzbogacić swoje animacje Vue, integrując je z popularnymi bibliotekami CSS i JavaScript. Vue <Transition> zostało zaprojektowane z myślą o takiej integracji - system custom class names i JS hooków czyni to prostym.

Custom Class Names

Zamiast automatycznych klas name-enter-active, name-leave-to itd., możesz wskazać własne klasy CSS. To kluczowe przy integracji z bibliotekami takimi jak Animate.css:

<Transition
  enter-active-class="animate__animated animate__bounceIn"
  leave-active-class="animate__animated animate__bounceOut"
>
  <div v-if="show">Panel statusu stacji</div>
</Transition>

Vue zamiast swoich automatycznych klas zastosuje podane klasy CSS bezpośrednio na element. Masz do dyspozycji 6 atrybutów custom class - jeden dla każdej fazy animacji:

  • enter-from-class - zastępuje name-enter-from
  • enter-active-class - zastępuje name-enter-active
  • enter-to-class - zastępuje name-enter-to
  • leave-from-class - zastępuje name-leave-from
  • leave-active-class - zastępuje name-leave-active
  • leave-to-class - zastępuje name-leave-to

Możesz mieszać custom classes z named transitions - podane atrybuty nadpiszą tylko wybrane fazy, a reszta będzie korzystać z prefiksu name.

CSS @keyframes

Oprócz CSS transition (zmiana z wartości A do B), możesz używać CSS animation z @keyframes - daje to kontrolę nad wieloetapowymi animacjami:

.bounce-enter-active {
  animation: bounce-in 0.5s;
}
.bounce-leave-active {
  animation: bounce-in 0.5s reverse;
}

@keyframes bounce-in {
  0% { transform: scale(0); opacity: 0; }
  50% { transform: scale(1.15); }
  70% { transform: scale(0.95); }
  100% { transform: scale(1); opacity: 1; }
}

Animacja bounce-in składa się z 4 kroków - element rośnie, lekko się kurczy (efekt "sprężyny") i stabilizuje. Przy wyjściu (reverse) animacja odtwarza się od końca.

Różnica transition vs animation

CSS transitionCSS animation
Zmiana z A do BWiele kroków (keyframes)
Wymaga zmiany stanu (-from, -to)Definiuje pełną sekwencję
ProstszeBardziej elastyczne
Jedno przejścieMoże się powtarzać

W Vue możesz łączyć oba podejścia. Gdy element ma zarówno transition jak i animation, użyj atrybutu type aby wskazać Vue, na co czekać:

<Transition name="mixed" type="animation">
  <!-- Vue będzie czekać na zakończenie animation, nie transition -->
</Transition>

Integracja z GSAP

GSAP (GreenSock Animation Platform) to najpotężniejsza biblioteka animacji w ekosystemie JavaScript. Integracja z Vue odbywa się przez JS hooks:

import gsap from 'gsap'

function onBeforeEnter(el) {
  el.style.opacity = 0
  el.style.transform = 'scale(0.5) translateY(30px)'
}

function onEnter(el, done) {
  gsap.to(el, {
    opacity: 1,
    scale: 1,
    y: 0,
    duration: 0.6,
    ease: 'elastic.out(1, 0.5)',
    onComplete: done
  })
}

function onLeave(el, done) {
  gsap.to(el, {
    opacity: 0,
    scale: 0.5,
    y: -30,
    duration: 0.4,
    ease: 'power2.in',
    onComplete: done
  })
}
<Transition
  :css="false"
  @before-enter="onBeforeEnter"
  @enter="onEnter"
  @leave="onLeave"
>
  <div v-if="showPanel">Reactor Control Panel</div>
</Transition>

Ważne: Przy użyciu GSAP (lub jakiejkolwiek biblioteki JS) dodaj :css="false" do Transition, aby Vue nie próbowało jednocześnie stosować klas CSS.

Integracja z Animate.css

Animate.css to popularna biblioteka gotowych animacji CSS. Po dodaniu jej do projektu:

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css" />

Użycie z Vue jest trywialne dzięki custom class names:

<Transition
  enter-active-class="animate__animated animate__fadeInUp"
  leave-active-class="animate__animated animate__fadeOutDown"
>
  <div v-if="visible" class="notification">
    New sensor reading available
  </div>
</Transition>

Możesz kontrolować czas trwania przez CSS custom properties:

.animate__animated {
  --animate-duration: 0.4s;
}

Wybór podejścia

SytuacjaPodejście
Proste fade/slideCSS transition z named classes
Wieloetapowe animacjeCSS @keyframes
Gotowe efektyAnimate.css + custom classes
Dynamiczne/złożoneGSAP + JS hooks
Fizyczne symulacjeGSAP z ease functions
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'

const showBox = ref(false)
</script>

<template>
  <div class="nova-lab">
    <h1>Integracja z Animate.css</h1>

    <button @click="showBox = !showBox" class="btn">
      Przełącz
    </button>

    <!-- Własne nazwy klas z Animate.css -->
    <Transition
      enter-active-class="animate__animated animate__bounceIn"
      leave-active-class="animate__animated animate__bounceOut"
    >
      <div v-if="showBox" class="cargo-box">
        Moduł ładunkowy Alfa-7
        <p>Status: Załadowany</p>
      </div>
    </Transition>

    <h2 style="margin-top: 30px;">CSS @keyframes</h2>
    <button @click="showBox = !showBox" class="btn">Przełącz (keyframes)</button>

    <Transition name="bounce">
      <div v-if="showBox" class="cargo-box alt">
        Moduł naukowy Beta-3
      </div>
    </Transition>
  </div>
</template>

<style scoped>
.nova-lab {
  background: #0a0e27;
  color: #00ff88;
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
h1, h2 { color: #00ff88; }
.btn {
  background: #00b4d8;
  color: white;
  border: none;
  padding: 10px 20px;
  border-radius: 8px;
  cursor: pointer;
  margin: 10px 0;
}
.cargo-box {
  background: rgba(0, 180, 216, 0.15);
  border: 2px solid #00b4d8;
  padding: 20px;
  border-radius: 12px;
  margin-top: 10px;
}
.cargo-box.alt {
  border-color: #9b59b6;
  background: rgba(155, 89, 182, 0.15);
}

/* animacja @keyframes */
.bounce-enter-active {
  animation: bounce-in 0.5s;
}
.bounce-leave-active {
  animation: bounce-in 0.5s reverse;
}
@keyframes bounce-in {
  0% { transform: scale(0); }
  50% { transform: scale(1.15); }
  100% { transform: scale(1); }
}
</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 najlepiej zintegrować GSAP z <Transition> w Vue?

  2. 2. Które atrybuty pozwalają nadpisać domyślne klasy Transition?

Zadania praktyczne w grze

  • Układanie w pionie

    Ułóż kroki integracji GSAP z Vue Transition:

  • Edytor kodu

    Użyj atrybutów enter-active-class i leave-active-class z klasami Animate.css.

  • Układanie w poziomie

    Ułóż atrybut custom class dla enter-active-class:

  • Edytor kodu

    Użyj gsap.from() w hooku @enter i gsap.to() w @leave.

  1. PytanieGSAP w Vue
  2. Ułóż w kolejnościKroki integracji GSAP
  3. Zadanie z kodemPraktyka: Animate.css z Vue
  4. Ułóż w kolejnościCustom class names
  5. PytanieCustom transition classes
  6. Zadanie z kodemPraktyka: GSAP w Transition

Przydatne artykuły