jackdoyle 5e6c35ff8e 3.15.1
- FIXED: if you define a scrollTrigger directly in a Flip.from() call, it will now work properly.

- FIXED: regression in 3.15.0: if you define an "ease" in the stagger object of a tween, it would replace the regular ease in the tween itself (not just the stagger distribution). Like gsap.to(".box", {x: 100, ease: "none", stagger: {each: 0.1, ease: "sine"}}) would cause the tween's ease to be "sine" instead of "none".

- FIXED: if the timeScale is changed on a paused animation whose playhead is before the start or after the end, it will now honor any delay that was set on it.

- FIXED: if you define specialChars on a SplitText, it may not be fully honored due to Intl.Segmenter pre-splitting. For a workaround see the splitArabicText() helper function at https://codepen.io/GreenSock/pen/azBWVPN?editors=0010

- FIXED: SplitText now correctly honors line breaks in rtl (right-to-left) text.

- FIXED: on high-refresh rates, the ticker could skip frames that are clumped together closer than 250Hz (4ms).

- FIXED: Safari doesn't honor line-height properly on SplitText elements that are masked unless the mask elements have vertical-align: top. We've added that in 3.15.1.

- FIXED: if you load EasePack and gsap.registerPlugin(EasePack), it will make all the eases inside EasePack available globally.

- FIXED: regression in 3.14 could cause the browser to jump to the top of the page on window resize when it hits a breakpoint when a ScrollTrigger is created inside a gsap.matchMedia(). See https://gsap.com/community/forums/topic/45542-resize-on-matchmedia-breakpoint-with-scrolltrigger-jumps-to-top-of-page/

- FIXED: after creating gsap.matchMedia() triggers, a subsequent revert() or kill() didn't remove the "change" event listener(s). That's fixed now. See https://github.com/greensock/GSAP/issues/654

- FIXED: if you create a zero-delay delayedCall() and then pause the globalTimeline and then resume it, it would skip the delayedCall. See https://gsap.com/community/forums/topic/45563-gsapdelayedcall0-%E2%80%A6-stuck-forever-if-global-timeline-is-paused-and-ticker-is-idle/

- FIXED: ScrollTrigger.refresh() could restore a stale scroll position. See https://github.com/greensock/GSAP/issues/655

- FIXED: SplitText may not clear a resize timeout when .kill() is called. See https://github.com/greensock/GSAP/issues/657

- FIXED: Refined some TypeScript definitions around RawPath. See https://github.com/greensock/GSAP/pull/659

- FIXED: creating a timeline with a very large quantity of .from() tweens could require excess processing time. See https://gsap.com/community/forums/topic/45584-question-about-build-time-for-large-timelines-with-from-tweens/

- FIXED: With 40+ pinned ScrollTriggers, Firefox might complain with "Too many attempts to navigate or modify history within a short timeframe." See https://github.com/greensock/GSAP/issues/660
2026-11-03 18:56:17 -06:00
2026-11-03 18:56:17 -06:00
2026-11-03 18:56:17 -06:00
2026-11-03 18:56:17 -06:00
2026-11-03 18:56:17 -06:00
2012-09-22 13:21:45 -05:00
2026-11-03 18:56:17 -06:00
2026-11-03 18:56:17 -06:00
2021-09-29 01:25:50 -05:00

GSAP (GreenSock Animation Platform)

GSAP - Animate anything

GSAP is a 100% free framework-agnostic JavaScript animation library that turns developers into animation superheroes. Build high-performance animations that work in every major browser. Animate CSS, SVG, canvas, React, Vue, WebGL, colors, strings, motion paths, generic objects... anything JavaScript can touch! GSAP's ScrollTrigger plugin delivers jaw-dropping scroll-based animations with minimal code. gsap.matchMedia() makes building responsive, accessibility-friendly animations a breeze.

No other library delivers such advanced sequencing, reliability, and tight control while solving real-world problems on over 12 million sites. GSAP works around countless browser inconsistencies; your animations just work. At its core, GSAP is a high-speed property manipulator, updating values over time with extreme accuracy.

GSAP is completely flexible; sprinkle it wherever you want. Zero dependencies.

There are many optional plugins and easing functions for achieving advanced effects easily like scrolling, morphing, text splitting, animating along a motion path or FLIP animations. There's even a handy Observer for normalizing event detection across browsers/devices.

GSAP is FREE!

Thanks to Webflow, GSAP is now 100% FREE including ALL of the bonus plugins like SplitText, MorphSVG, and all the others that were exclusively available to Club GSAP members. That's right - the entire GSAP toolset is FREE, even for commercial use! 🤯 Read more here

Get Started

Get Started with GSAP

Docs & Installation

View the full documentation here, including an installation guide.

CDN

<script src="https://cdn.jsdelivr.net/npm/gsap@3.15/dist/gsap.min.js"></script>

See JSDelivr's dedicated GSAP page for quick CDN links to the core files/plugins. There are more installation instructions at gsap.com.

Every major ad network excludes GSAP from file size calculations and most have it on their own CDNs, so contact them for the appropriate URL(s).

NPM

See the guide to using GSAP via NPM here.

npm install gsap

GSAP's core can animate almost anything including CSS and attributes, plus it includes all of the utility methods like interpolate(), mapRange(), most of the eases, and it can do snapping and modifiers.

// typical import
import gsap from "gsap";

// get other plugins:
import ScrollTrigger from "gsap/ScrollTrigger";
import Flip from "gsap/Flip";
import Draggable from "gsap/Draggable";

// or all tools are exported from the "all" file:
import { gsap, ScrollTrigger, Draggable, MotionPathPlugin } from "gsap/all";

// don't forget to register plugins
gsap.registerPlugin(ScrollTrigger, Draggable, Flip, MotionPathPlugin); 

The NPM files are ES modules, but there's also a /dist/ directory with UMD files for extra compatibility.

ScrollTrigger & ScrollSmoother

If you're looking for scroll-driven animations, GSAP's ScrollTrigger plugin is the standard. There's a companion ScrollSmoother as well.

ScrollTrigger

Using React?

There's a @gsap/react package that exposes a useGSAP() hook which is a drop-in replacement for useEffect()/useLayoutEffect(), automating cleanup tasks. Please read the React guide for details.

Resources

Need help?

Ask in the friendly GSAP forums. Or share your knowledge and help someone else - it's a great way to sharpen your skills! Report any bugs there too (or file an issue here if you prefer).

License

GreenSock's standard "no charge" license can be viewed at https://gsap.com/standard-license.

Copyright (c) 2008-2026, GreenSock. All rights reserved.

S
Description
GSAP(GreenSock 动画平台),一个面向现代网络的 JavaScript 动画库
Readme 14 MiB
Languages
JavaScript 98.6%
TypeScript 1.4%