Kurs Vue.js · Moduł 13: Przejścia i animacje
JavaScript Animation Hooks
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
@before-enter(el)- wywoływany zanim element zostanie wstawiony do DOM. Tutaj ustawiasz stan początkowy animacji (np.opacity: 0,scale: 0.5).@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!@after-enter(el)- wywoływany po zakończeniu animacji (podone()). Tutaj sprzątasz po animacji (usuwasz inline styles itp.).@enter-cancelled(el)- wywoływany gdy animacja wejścia zostanie przerwana (np. użytkownik szybko toggle'uje element).
Hooki wyjścia (leave) - analogiczna kolejność
@before-leave(el)- stan początkowy wyjścia, element jest jeszcze widoczny@leave(el, done)- animacja wyjścia, musisz wywołaćdone()!@after-leave(el)- cleanup po wyjściu@leave-cancelled(el)- przerwanie animacji wyjścia (tylko zv-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 klas | Użyj JS hooków |
|---|---|
| Proste fade, slide | Dynamiczne wartości animacji |
| Stałe czasy trwania | Czasy zależne od danych |
| Typowe przejścia | Integracja z GSAP, Anime.js |
| Większość przypadków | Zł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. Który JavaScript hook jest wywoływany gdy element wchodzi do DOM?
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: