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);
}
}
});
