self (makes chaining easier)
Version:
GreenSock Docs
Back to GSAP
Tween
Methods
.delay()
.duration()
.endTime()
.eventCallback()
.from()
.fromTo()
.invalidate()
.isActive()
.iteration()
.kill()
.pause()
.paused()
.play()
.progress()
.repeat()
.repeatDelay()
.restart()
.resume()
.reverse()
.reversed()
.seek()
.set()
.startTime()
.then()
.time()
.timeScale()
.to()
.totalDuration()
.totalProgress()
.totalTime()
.yoyo()
Tween
.pause()
.pause( atTime:*, suppressEvents:Boolean ) : *
Pauses the instance, optionally jumping to a specific time.
Parameters
atTime: *
(default = null) — The time (or label for Timeline 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 timeline 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);