seek
seek( position:*, suppressEvents:Boolean ):self
[覆盖] 跳转到特定时间(或标签),而不影响实例是否暂停或倒放。
参数
位置: *
要跳转到的位置,可以通过以下任意一种方式描述:数值表示绝对位置,例如 3 表示从时间轴开始处的精确 3 秒位置。字符串值可以是一个标签(例如 "myLabel"),也可以是使用 "+=" 或 "-=" 前缀的相对值,例如 "-=2"(时间轴结束前 2 秒),或者组合形式如 "myLabel+=2" 表示在 "myLabel" 标签后 2 秒。详见位置参数文章其中包含交互式时间轴可视化演示和视频。
suppressEvents:布尔值
(默认值 =
true
) - 如果true
(默认),当播放头移动到由time
参数。
返回值:self
self(便于链式调用)
细节
跳转到特定时间点(或标签),但不会影响实例是否暂停或倒放。
如果播放头原来的位置和新时间之间有任何事件/回调,它们将不会被触发,因为默认情况下是这样处理的。suppressEvents
(第二个参数)为true
。可以想象成像是将唱片机上的唱针提起并移动到新的位置,然后再放回唱片上。然而,如果你不希望在初始移动期间抑制这些事件/回调,请直接设置suppressEvents
以获取一个false
.
//jumps to exactly 2 seconds
tl.seek(2);
//jumps to exactly 2 seconds but doesn't suppress events during the initial move:
tl.seek(2, false);
//jumps to the "myLabel" label
tl.seek("myLabel");