Jump to content
GreenSock

TimelineMax

.seek()

.seek( position:*, suppressEvents:Boolean ) : *

[override] Jumps to a specific time (or label) without affecting whether or not the instance is paused or reversed.

Parameters

position: *

The position to go to, described in any of the following ways: a numeric value indicates an absolute position, like 3 would be exactly 3 seconds from the beginning of the timeline. A string value can be either a label (i.e. “myLabel”) or a relative value using the “+=” or “-=” prefixes like “-=2” (2 seconds before the end of the timeline) or a combination like “myLabel+=2” to indicate 2 seconds after “myLabel”.

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 timeparameter.

Returns : *

self (makes chaining easier)

Details

Jumps to a specific time (or label) without affecting whether or not the instance is paused or reversed.

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.

//jumps to exactly 2 seconds
myAnimation.seek(2);

//jumps to exactly 2 seconds but doesn't suppress events during the initial move:
myAnimation.seek(2, false);

//jumps to the "myLabel" label
myAnimation.seek("myLabel");
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.
×