Jump to content
GreenSock

TweenMax.killTweensOf()

TweenMax.killTweensOf( target:Object, vars:Object ) :

[static] Kills all the tweens (or specific tweening properties) of a particular object or the delayedCalls to a particular function.

Parameters

target: Object

Object whose tweens should be killed immediately or selector text to feed the selector engine to find the target(s). You may also pass in an array of targets.

vars: Object

(default = null) — To kill only specific properties, use a generic object containing enumerable properties corresponding to the ones that should be killed like {x:true, y:true}. The values assigned to each property don’t matter – the sole purpose of the object is for iteration over the named properties (in this case, x and y). If no object (or null) is defined, all matched tweens will be killed in their entirety.

Details

Kills all the tweens (or specific tweening properties) of a particular object or the delayedCalls to a particular function. If, for example, you want to kill all tweens of myObject, you'd do this:


TweenMax.killTweensOf(myObject);


To kill only particular tweening properties of the object, use the second parameter. For example, if you only want to kill all the tweens of myObject.opacity and myObject.x, you'd do this:


TweenMax.killTweensOf(myObject, {opacity:true, x:true});


To kill all the delayedCalls (like ones created using TweenMax.delayedCall(5, myFunction);), you can simply callTweenMax.killTweensOf(myFunction); because delayedCalls are simply tweens that have their target and onComplete set to the same function (as well as a delay of course).

As of version 1.8.0, you can also pass in a string that defines selector text, like "#myID" to kill the tweens of the element with an ID of "myID". You may also pass in an array of targets.

killTweensOf() affects tweens that haven't begun yet too. If, for example, a tween of myObject has a delay of 5 seconds andTweenLite.killTweensOf(myObject) is called 2 seconds after the tween was created, it will still be killed even though it hasn't started yet.

Copyright 2017, GreenSock. All rights reserved. This work is subject to theterms of useor for Club GreenSock members, the software agreement that was issued with the membership.
×