time
time(value:Number, suppressEvents:Boolean):[Number | self]
[覆盖] 获取或设置播放头的本地位置(本质上是当前时间),不包括任何重复或重复延迟。
参数
值: 数值
(默认值 =
NaN
) - 如果省略参数,则返回当前值(getter);而如果定义了参数,则会设置该值(setter),并返回实例本身以便更容易地进行链式调用。负值将被解释为从结尾开始倒数。结束位置开始解释。动画的持续时间。suppressEvents:布尔值
(默认值 =
false
) - 如果true
当时间轴移动到由value
参数。
返回值:[数字 | 自身实例]
省略参数将返回当前值(getter),而定义参数将设置值(setter)并返回实例本身以便于链式调用。
细节
获取或设置播放头的本地位置(本质上是当前时间),有包括任何重复(repeats)或重复延迟(repeatDelays)。如果时间轴具有非零的repeat
,即使totalTime
仍然线性向前继续计时(或者如果yoyo
设置为true
,则会返回time
在正向和反向之间交替移动)。time
永远不会超过其持续时间,而totalTime
反映包括所有重复和重复延迟在内的总时间。
例如,如果一个时间轴实例具有duration
为2,并且重复了3次,totalTime
在时间轴执行期间,其时间值将从 0 变化到 8(播放一次后重复三次,总共四个周期)time
的值则会在每个周期中从0变为2,共四次。
此方法既可以作为获取器(getter)也可以作为设置器(setter)使用。省略参数将返回当前值(getter),而提供参数则会设置该值(setter)并返回实例本身以便更容易进行链式调用。
//gets current time
var currentTime = tl.time();
//sets time, jumping to new value just like seek()
tl.time(2); .