Important information about GSAP 1.17.0

[Carl]

Hi Folks,

 

We’re super excited about the release of 1.17.0. It contains heaps of enhancements for SVG, new features, updates to Draggable and some bug fixes.

 

Important: There is one API change in 1.17.0 that may impact a small number of legacy projects that alter transformOrigin on SVG elements. We’ve enabled a new feature called smoothOrigin that makes altering the transformOrigin on transformed SVG elements much more intuitive and hassle-free. You can read about this feature and watch a video explaining it in detail at http://www.greensock.com/svg-tips.

 

If upgrading to 1.17.0 causes any unexpected results to your existing SVG animations, the fix is easy: just add the following code before you create any animations:

CSSPlugin.defaultSmoothOrigin = false;

That’s it. You’re back to the old behavior.

 

We take API changes that affect legacy code very seriously and it is extremely rare that we even consider making such a change. However, after much thought and input from top SVG animators it was clear that enabling smoothOrigin would be the best thing for the vast majority of users moving forward.

 

As always, we encourage you to test thoroughly before upgrading. When loading GSAP from cdnjs into your production sites you should always link to files with specific version numbers: /1.17.0/TweenMax.min.js (not /latest/TweenMax.min.js).

 

If you experience any issues that cannot be solved by using the code snippet above, please let us know.

 

If you haven’t done so already, check out the SVG Tips article and take 1.17.0 for a spin. We think you’re really going to love all the SVG features of GSAP and other improvements.

 

Happy Tweening!

Team GreenSock

 

Full release notes for 1.17.0