self (makes chaining easier)
GreenSock Docs
TweenMax
.pause()
Pauses the instance, optionally jumping to a specific time.
Parameters
atTime: *
(default = null
) — The time (or label for TimelineLite/TimelineMax instances) that the instance should jump to before pausing (if none is defined, it will pause wherever the playhead is currently located).
suppressEvents: Boolean
default = true
) — If
true
(the default), no events or callbacks will be triggered when the playhead moves to the new position defined in the atTime
parameter.
Returns : *

Details
Pauses the instance, optionally jumping to a specific time.
If you define a time to jump to (the first parameter, which could also be a label for TimelineLite or TimelineMax instances), the playhead moves there immediately and if there are any events/callbacks inbetween where the playhead was and the new time, they will not be triggered because by default suppressEvents
(the 2nd parameter) is true
. Think of it like picking the needle up on a record player and moving it to a new position before placing it back on the record. If, however, you do not want the events/callbacks suppressed during that initial move, simply set the suppressEvents
parameter to false
.
//pauses wherever the playhead currently is:
myAnimation.pause();
//jumps to exactly 2-seconds into the animation and then pauses:
myAnimation.pause(2);
//jumps to exactly 2-seconds into the animation and pauses but doesn't suppress events during the initial move:
myAnimation.pause(2, false);