Name of the label that is before the time passed to previousLabel(). If no time is provided, the timeline's current playhead time will be used.
Version:
GreenSock Docs
Back to GSAP
Timeline
Methods
.add()
.addLabel()
.addPause()
.call()
.clear()
.currentLabel()
.delay()
.duration()
.endTime()
.eventCallback()
.from()
.fromTo()
.getChildren()
.getTweensOf()
.invalidate()
.isActive()
.iteration()
.kill()
.nextLabel()
.pause()
.paused()
.play()
.previousLabel()
.progress()
.recent()
.remove()
.removeLabel()
.removePause()
.repeat()
.repeatDelay()
.restart()
.resume()
.reverse()
.reversed()
.seek()
.set()
.shiftChildren()
.startTime()
.then()
.time()
.timeScale()
.to()
.totalDuration()
.totalProgress()
.totalTime()
.tweenFromTo()
.tweenTo()
.yoyo()
Timeline
.previousLabel()
.previousLabel( time:Number ) : String
Returns the label name before the time provided. If no time
Parameters
time: Number
The time to get the previous label from.
Returns : String
Details
Returns the previous label (if any) that occurs before the time parameter. If no time is provided, the timeline's current playhead time will be used. It makes no difference if the timeline is reversed (“before” means earlier in the timeline’s local time zone).
A label that is positioned exactly at the same time as the time parameter will be ignored.
You could use previousLabel() in conjunction with tweenTo() to make the timeline tween back to the previous label like this:
myTimeline.tweenTo( myTimeline.previousLabel() );