GSAP 是面向现代 Web 的专业级 JavaScript 动画库,提供高性能补间动画(tween)、强大的序列编排、基于滚动的动画以及插件生态。本条目以最佳实践形式整理了 GSAP 的核心概念、安装方式、常用模式与常见错误。
用途与主要能力
- 补间动画:使用 gsap.to / gsap.from / gsap.fromTo 对属性做随时间变化的高性能动画,gsap.set 可瞬时设置属性。
- 时间线编排:使用 gsap.timeline 精确排布多个补间,支持位置参数(如 '-=0.5' 重叠、'<' 与上一段同时开始)、标签与嵌套,并支持 play、reverse、progress 等播放控制。
- 滚动动画:ScrollTrigger 将动画与滚动位置关联,支持 trigger、start、end、scrub、pin、snap 等配置;条目中另列出 ScrollSmoother(平滑滚动与视差)参考。
- 文本与 SVG:SplitText 做文本拆分动画,DrawSVG、MorphSVG、MotionPath 处理 SVG 描边、形变与路径运动,TextPlugin、ScrambleTextPlugin 处理文本内容动画。
- 布局与交互:Flip 实现 FLIP 布局动画,Observer、Draggable 处理手势检测与拖拽交互。
- 工具函数:gsap.utils 提供 toArray、clamp、interpolate、selector 等辅助方法,gsap.matchMedia 支持响应式条件。
安装与注册
- 核心库:npm install gsap
- React hook:npm install @gsap/react
- 插件需在应用入口注册一次,例如 import { ScrollTrigger } from 'gsap/ScrollTrigger' 后调用 gsap.registerPlugin(ScrollTrigger)。
使用方式 条目提供从基础补间、缓动、时间线、交错动画到 ScrollTrigger、React useGSAP、SVG 插件等的参考索引,并给出淡入、列表交错、滚动触发、带控制的时间线等常见代码模式。在 React 中建议使用 useGSAP hook 并配合 scope 做自动清理。
常见错误与限制 条目列出应避免的问题:未注册插件导致功能失效;React 中缺少清理造成内存泄漏或残留动画;多个补间争用同一属性需使用 overwrite 或 killTweensOf;DOM 或布局变化后需调用 ScrollTrigger.refresh();对尚不存在的元素做动画应延迟或使用 immediateRender: false;from() 会立即渲染可能造成闪烁,可用 CSS 初始状态配合 to() 或 fromTo();选择器未限定作用域会误伤页面其他元素,可用 scope 或 gsap.utils.selector 限定。
插件授权方面,条目注明 ScrollTrigger、Observer、Draggable、Flip、TextPlugin、ScrollTo 为免费,ScrollSmoother、SplitText、DrawSVG、MorphSVG、MotionPath 属于 Club 授权。具体价格与完整授权条款暂未提供。