Vue Academy · 강의

JavaScript Transition 훅

@before-enter, @enter, @after-enter, @leave 훅과 복잡한 애니메이션을 위한 GSAP 사용법을 다룹니다.

JavaScript Transition 훅은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

JavaScript 훅이 필요한 이유

CSS 클래스는 대부분의 경우를 처리하지만, 일부 애니메이션에는 JavaScript가 필요합니다. 예를 들어 GSAP 같은 라이브러리를 통합하거나, 캔버스를 애니메이션으로 만들거나, 동적 값을 계산할 때입니다. <Transition>은 바로 이러한 작업을 위한 수명 주기 훅을 제공합니다.

사용 가능한 훅

Vue는 각 단계마다 이벤트를 발생시킵니다. @before-enter, @enter, @after-enter, @enter-cancelled와 이에 대응하는 이탈 훅이 있습니다.

<Transition
  @before-enter="onBeforeEnter"
  @enter="onEnter"
  @after-enter="onAfterEnter"
  @leave="onLeave"
>
  <div v-if="show">Animated by JS</div>
</Transition>

진입 전 훅으로 초기 상태 설정

@before-enter는 DOM 요소를 전달받으며 삽입 전에 실행됩니다. enter-from 클래스와 마찬가지로 시작 스타일을 설정할 때 사용합니다.

function onBeforeEnter(el) {
  el.style.opacity = 0;
  el.style.transform = "translateY(20px)";
}

진입 훅은 요소와 완료 콜백을 받음

@enter는 두 개의 인수를 받습니다. 요소와 done 콜백입니다. 요소를 애니메이션으로 만든 다음 작업이 끝나면 done()을 호출해야 Vue가 전환이 끝났다는 것을 알 수 있습니다.

function onEnter(el, done) {
  // animate to final state
  el.style.transition = "all 0.4s ease";
  el.style.opacity = 1;
  el.style.transform = "translateY(0)";
  el.addEventListener("transitionend", done, { once: true });
}

항상 done 호출하기

done()을 호출하는 것을 잊으면 Vue가 무한히 기다리므로 전환이 완료되지 않습니다. after-enter도 실행되지 않고 요소가 애니메이션이 중간에 멈춘 상태로 남을 수 있습니다. JavaScript로 제어하는 훅에서는 반드시 호출해야 합니다.

function onEnter(el, done) {
  // ... animate ...
  setTimeout(done, 400); // fallback if no transitionend
}

done을 사용하는 이탈 훅

@leave 훅도 같은 방식으로 작동합니다. 요소를 화면 밖으로 애니메이션으로 이동한 다음 done()을 호출하면 Vue가 DOM에서 요소를 제거합니다.

function onLeave(el, done) {
  el.style.transition = "all 0.3s ease";
  el.style.opacity = 0;
  el.addEventListener("transitionend", done, { once: true });
}

정리를 위한 after-enter

@after-enter는 진입이 끝난 뒤 한 번 실행됩니다. 인라인 스타일을 제거하거나, 전환 속성을 초기화하거나, 후속 로직을 실행할 때 사용합니다.

function onAfterEnter(el) {
  el.style.transition = "";
  el.style.transform = "";
}

:css="false"로 CSS 건너뛰기

애니메이션을 전적으로 JavaScript로 처리할 때는 :css="false"로 설정합니다. 이렇게 하면 Vue가 CSS 클래스 감지를 완전히 건너뛰고, 타이밍을 결정할 때 done 콜백만 사용합니다. 예기치 않은 CSS 간섭도 방지할 수 있습니다.

<Transition
  :css="false"
  @enter="onEnter"
  @leave="onLeave"
>
  <div v-if="show">Pure JS animation</div>
</Transition>

GSAP 통합하기

애니메이션 라이브러리를 사용할 때 JavaScript 훅의 장점이 잘 드러납니다. GSAP는 요소에 트윈 애니메이션을 적용하고 done을 onComplete 콜백으로 받을 수 있습니다.

function onEnter(el, done) {
  gsap.from(el, {
    opacity: 0,
    y: 30,
    duration: 0.4,
    onComplete: done
  });
}

취소된 훅

전환이 중단되면(예를 들어 사용자가 빠르게 토글하면) @enter-cancelled와 @leave-cancelled가 실행됩니다. 실행 중인 트윈 애니메이션을 중단하고 남은 상태가 생기지 않도록 할 때 사용합니다.

function onEnterCancelled(el) {
  gsap.killTweensOf(el);
}

JavaScript 훅을 선택할 때

물리 효과, 요소마다 달라지는 동적 값, 라이브러리 통합 또는 정확한 순서 제어가 필요할 때 JavaScript 훅을 사용합니다. 단순한 페이드와 슬라이드에는 CSS 클래스가 더 간단하고 성능도 좋습니다.

간단히 확인하기

JavaScript 훅과 함께 :css="false"를 전달하는 이유는 무엇인가요?

복습

JavaScript 전환 훅을 배웠습니다. @before-enter는 초기 상태를 설정하고, @enter/@leave는 애니메이션을 실행한 뒤 done을 호출하며, @after-enter는 정리를 수행합니다. 또한 :css="false"로 CSS 클래스를 우회하고, 중단에 대응하는 취소 훅도 사용할 수 있습니다.

자주 묻는 질문

“JavaScript Transition 훅” 강의는 무료인가요?

네 — “JavaScript Transition 훅” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“JavaScript Transition 훅”에서 뭘 배우나요?

@before-enter, @enter, @after-enter, @leave 훅과 복잡한 애니메이션을 위한 GSAP 사용법을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Vue Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“JavaScript Transition 훅” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Vue Academy(으)로 돌아가기