Post

GSAP ScrollTrigger 애니메이션 기능 정리

💡GSAP ScrollTrigger 애니메이션 기능 정리

GSAP(GreenSock Animation Platform)은 웹 페이지에 다양한 애니메이션을 추가할 수 있는 강력한 라이브러리입니다. 그 중에서도 ScrollTrigger 플러그인은 스크롤 이벤트를 활용하여 요소의 애니메이션을 제어하는 기능을 제공합니다. 아래에서는 ScrollTrigger의 주요 기능들에 대해 알아보겠습니다.

💡01. 기본 애니메이션

ScrollTrigger를 사용하여 요소를 이동시키고 변형시키는 가장 간단한 방법은 GSAP의 to 메서드를 사용하는 것입니다. 이 메서드를 사용하면 요소를 특정 지속 시간 동안 이동시키고 회전시키는 등의 기본 애니메이션을 생성할 수 있습니다.

1
2
3
4
5
6
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    borderRadius: 100 // 요소의 테두리 반지름
});

💡02. 트리거 사용

ScrollTrigger를 통해 특정 요소가 화면에 나타날 때 애니메이션이 시작되도록 설정할 수 있습니다. 이를 위해 scrollTrigger 객체에서 트리거 요소를 지정합니다.

1
2
3
4
5
6
7
8
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        trigger: "#triggerElement" // 트리거 요소의 선택자
    }
});

💡03. toggleActions 사용

ScrollTrigger의 toggleActions 옵션은 스크롤 방향에 따라 애니메이션을 처리하는 방식을 설정합니다. “play”, “reverse”, “none” 등의 옵션을 사용하여 스크롤 방향에 따라 애니메이션을 재생하거나 되감을 수 있습니다.

1
2
3
4
5
6
7
8
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        toggleActions: "play none reverse none" // 상황별 애니메이션 처리 설정
    }
});

💡04. start와 end 사용

ScrollTrigger의 start와 end 옵션을 사용하면 애니메이션의 시작과 끝을 조절할 수 있습니다. 이 옵션을 사용하여 스크롤 위치를 기준으로 애니메이션을 시작하거나 끝날 위치를 설정할 수 있습니다.

1
2
3
4
5
6
7
8
9
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        start: "top 50%",   // 애니메이션 시작 위치
        end: "bottom 30%"   // 애니메이션 끝나는 위치
    }
});

💡05. scrub 사용

scrub 옵션을 사용하면 스크롤에 따라 애니메이션을 부드럽게 조절할 수 있습니다. 스크롤을 할 때 요소가 부드럽게 따라 움직입니다.

1
2
3
4
5
6
7
8
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        scrub: true // true로 설정하면 스크롤에 따라 부드럽게 조절
    }
});

💡06. pin 사용

pin 옵션을 사용하면 요소를 스크롤에 고정시킬 수 있습니다. 이를 통해 요소가 화면에 고정되어 스크롤에 따라 따라다닐 수 있습니다.

1
2
3
4
5
6
7
8
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        pin: true // true로 설정하면 요소가 스크롤에 고정됨
    }
});

💡07. toggleClass 사용

toggleClass 옵션을 사용하면 스크롤 이벤트에 따라 요소에 클래스를 토글할 수 있습니다. 이를 통해 스크롤을 내리면 요소에 클래스가 추가되고, 올리면 다시 제거됩니다.

1
2
3
4
5
6
7
8
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        toggleClass: "active" // 스크롤 이벤트에 따라 토글될 클래스명
    }
});

💡08. 콜백 함수 사용

ScrollTrigger를 사용할 때 onUpdate, onToggle 등의 콜백 함수를 지정할 수 있습니다. 이를 통해 스크롤 이벤트에 대한 특정 동작을 수행할 수 있습니다.

1
2
3
4
5
6
7
8
9
gsap.to("#element", {
    duration: 2,      // 애니메이션 지속 시간 (초)
    x: 500,           // x 축으로 이동하는 거리
    rotation: 360,    // 회전 각도 (360도)
    scrollTrigger: {
        onUpdate: (self) => { console.log("onUpdate", self.progress.toFixed(3)) },
        onToggle: (self) => { console.log("onToggle", self.isActive) },
    }
});

onUpdate 콜백 함수

onUpdate 콜백 함수는 스크롤 이벤트가 발생할 때마다 호출됩니다. 이 함수를 사용하면 현재 스크롤 위치를 확인하거나 애니메이션의 진행 상태를 감지할 수 있습니다.

예를 들어, 현재 스크롤 위치에 따라 특정 작업을 수행하고 싶을 때 onUpdate 콜백 함수를 사용할 수 있습니다. 아래 예제에서는 스크롤 위치에 따라 콘솔에 현재 진행 상태를 출력합니다.

1
2
3
4
5
6
7
8
9
10
gsap.to("#element", {
    duration: 2,
    x: 500,
    rotation: 360,
    scrollTrigger: {
        onUpdate: (self) => { 
            console.log("현재 진행 상태:", self.progress.toFixed(3)); 
        }
    }
});

onToggle 콜백 함수

onToggle 콜백 함수는 애니메이션의 상태가 변경될 때마다 호출됩니다. 이 함수를 사용하면 애니메이션이 활성화되거나 비활성화될 때 특정 작업을 수행할 수 있습니다.

예를 들어, 애니메이션이 활성화되었는지 여부를 콘솔에 출력하고 싶을 때 onToggle 콜백 함수를 사용할 수 있습니다. 아래 예제에서는 애니메이션이 활성화되었는지 여부를 콘솔에 출력합니다.

1
2
3
4
5
6
7
8
9
10
gsap.to("#element", {
    duration: 2,
    x: 500,
    rotation: 360,
    scrollTrigger: {
        onToggle: (self) => { 
            console.log("애니메이션 활성화 여부:", self.isActive); 
        }
    }
});
This post is licensed under CC BY 4.0 by the author.