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

JavaScript Animation Hooks

3 min czytania ·
W tej lekcji7

Klasy CSS to "autopilot" animacji - działa świetnie dla prostych przejść. Ale czasem potrzebujesz pełnej kontroli nad animacjami - np. dynamicznie obliczanych wartości, animacji zależnych od danych, albo integracji z bibliotekami JS. W takich przypadkach Vue oferuje JavaScript animation hooks - jak ręczne sterowanie rakietą zamiast automatycznego lotu.

Dostępne hooki

<Transition> emituje zdarzenia na każdym etapie animacji. Możesz na nie nasłuchiwać:

<Transition
  :css="false"
  @before-enter="onBeforeEnter"
  @enter="onEnter"
  @after-enter="onAfterEnter"
  @enter-cancelled="onEnterCancelled"
  @before-leave="onBeforeLeave"
  @leave="onLeave"
  @after-leave="onAfterLeave"
  @leave-cancelled="onLeaveCancelled"
>
  <div v-if="show">...</div>
</Transition>

Hooki wejścia (enter) - kolejność wywołania

  1. @before-enter(el) - wywoływany zanim element zostanie wstawiony do DOM. Tutaj ustawiasz stan początkowy animacji (np. opacity: 0, scale: 0.5).

  2. @enter(el, done) - wywoływany w następnej klatce po wstawieniu elementu. Tu uruchamiasz właściwą animację. Musisz wywołać done() gdy animacja się zakończy!

  3. @after-enter(el) - wywoływany po zakończeniu animacji (po done()). Tutaj sprzątasz po animacji (usuwasz inline styles itp.).

  4. @enter-cancelled(el) - wywoływany gdy animacja wejścia zostanie przerwana (np. użytkownik szybko toggle'uje element).

Hooki wyjścia (leave) - analogiczna kolejność

  1. @before-leave(el) - stan początkowy wyjścia, element jest jeszcze widoczny
  2. @leave(el, done) - animacja wyjścia, musisz wywołać done()!
  3. @after-leave(el) - cleanup po wyjściu
  4. @leave-cancelled(el) - przerwanie animacji wyjścia (tylko z v-show)

Atrybut :css="false"

Gdy używasz wyłącznie hooków JS, dodaj :css="false" aby Vue nie próbowało stosować klas CSS ani nasłuchiwać na transitionend/animationend:

<Transition :css="false" @enter="onEnter" @leave="onLeave">
  <div v-if="show">Panel kontrolny</div>
</Transition>

Bez tego atrybutu Vue będzie czekało zarówno na callback done(), jak i na zdarzenie CSS transition - co może powodować nieprzewidywalne zachowanie.

Callback done() - kluczowy element

done() jest obowiązkowy w hookach @enter i @leave. Informuje Vue, że animacja się zakończyła i można przejść do następnego kroku:

function onBeforeEnter(el) {
  // Stan początkowy - element niewidoczny
  el.style.opacity = 0
  el.style.transform = 'translateY(20px)'
}

function onEnter(el, done) {
  // Wymuś reflow, aby przeglądarka zarejestrowała stan początkowy
  el.offsetHeight

  // Uruchom animację
  el.style.transition = 'all 0.5s ease'
  el.style.opacity = 1
  el.style.transform = 'translateY(0)'

  // Powiadom Vue gdy animacja się zakończy
  el.addEventListener('transitionend', done, { once: true })
}

function onAfterEnter(el) {
  // Cleanup - usuń inline transition
  el.style.transition = ''
}

Bez wywołania done() Vue nie wie kiedy animacja się zakończyła - w przypadku @leave element nigdy nie zostanie usunięty z DOM.

Praktyczny przykład - animacja zależna od danych

Hooki JS pozwalają na dynamiczne wartości, czego CSS classes nie umożliwiają:

function onEnter(el, done) {
  // Dynamiczny kierunek animacji na podstawie danych
  const direction = el.dataset.direction || 'left'
  const offset = direction === 'left' ? '-100px' : '100px'

  el.style.opacity = 0
  el.style.transform = `translateX(${offset})`
  el.offsetHeight // reflow

  el.style.transition = 'all 0.4s ease-out'
  el.style.opacity = 1
  el.style.transform = 'translateX(0)'

  el.addEventListener('transitionend', done, { once: true })
}

Kiedy używać hooków JS zamiast CSS?

Użyj CSS klasUżyj JS hooków
Proste fade, slideDynamiczne wartości animacji
Stałe czasy trwaniaCzasy zależne od danych
Typowe przejściaIntegracja z GSAP, Anime.js
Większość przypadkówZłożone sekwencje animacji
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'

const showAlert = ref(false)

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

function onEnter(el, done) {
  // Animacja wejścia bez CSS
  el.offsetHeight // wymuszenie reflow
  el.style.transition = 'all 0.6s ease'
  el.style.opacity = 1
  el.style.transform = 'scale(1)'
  el.addEventListener('transitionend', done, { once: true })
}

function onLeave(el, done) {
  el.style.transition = 'all 0.4s ease'
  el.style.opacity = 0
  el.style.transform = 'scale(0.5) rotate(10deg)'
  el.addEventListener('transitionend', done, { once: true })
}
</script>

<template>
  <div class="nova-lab">
    <h1>JavaScript Animation Hooks</h1>

    <button @click="showAlert = !showAlert" class="btn">
      {{ showAlert ? 'Zamknij alert' : 'Pokaż alert' }}
    </button>

    <Transition
      :css="false"
      @before-enter="onBeforeEnter"
      @enter="onEnter"
      @leave="onLeave"
    >
      <div v-if="showAlert" class="alert">
        UWAGA: Wykryto anomalię grawitacyjną w sektorze 7!
      </div>
    </Transition>
  </div>
</template>

<style scoped>
.nova-lab {
  background: #0a0e27;
  color: #00ff88;
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
h1 { color: #00ff88; }
.btn {
  background: #e74c3c;
  color: white;
  border: none;
  padding: 10px 20px;
  border-radius: 8px;
  cursor: pointer;
  margin: 15px 0;
}
.alert {
  background: rgba(231, 76, 60, 0.2);
  border: 2px solid #e74c3c;
  color: #e74c3c;
  padding: 20px;
  border-radius: 12px;
  font-size: 16px;
}
</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. Który JavaScript hook jest wywoływany gdy element wchodzi do DOM?

  2. 2. Co należy wywołać na końcu hooka @enter aby poinformować Vue o zakończeniu animacji?

Zadania praktyczne w grze

  • Układanie w pionie

    Ułóż hooki JavaScript Transition w kolejności wywołania (wejście):

  • Edytor kodu

    Zaimplementuj @enter i @leave z użyciem el.style i done() callback.

  • Klikanie w kolejności

    Ułóż kod hooka @enter w prawidłowej kolejności:

  • Układanie w poziomie

    Ułóż składnię Transition wyłączającą klasy CSS:

  • Edytor kodu

    Użyj :css='false' i hooków JS do animacji opacity i scale.

  • Układanie w poziomie

    Ułóż deklarację hooka @leave w template:

  1. PytanieHook onEnter
  2. Ułóż w kolejnościKolejność hooków wejścia
  3. Zadanie z kodemPraktyka: JS Animation Hooks
  4. PytanieCallback done()
  5. Kliknij w kolejnościWywołanie hooka enter
  6. Ułóż w kolejnościAtrybut :css='false'
  7. Zadanie z kodemPraktyka: Animacja bez CSS
  8. Ułóż w kolejnościSkładnia hooka leave

Przydatne artykuły