跳过主要内容

time

time(value:Number, suppressEvents:Boolean):[Number | self]

[覆盖] 获取或设置播放头的本地位置(本质上是当前时间),不包括任何重复或重复延迟。

参数

  • : 数值

    (默认值 =NaN) - 如果省略参数,则返回当前值(getter);而如果定义了参数,则会设置该值(setter),并返回实例本身以便更容易进行链式调用。负值将从动画的结束位置开始解释。动画的持续时间。

  • suppressEvents:布尔值

    (默认值 =false) - 如果true当时间轴移动到由value参数。

返回值:[数字 | 自身实例]

省略参数将返回当前值(getter),而定义参数将设置值(setter)并返回实例本身以便于链式调用。

细节

获取或设置播放头的本地位置(本质上是当前时间),包括任何重复(repeats)或重复延迟(repeatDelays)。如果补间动画有一个非零的repeat值,time每次重复时都会回到零,即使totalTime仍然线性向前继续计时(或者如果yoyo设置为true,则会返回time在正向和反向之间交替移动)。time永远不会超过其持续时间,而totalTime反映包括所有重复和重复延迟在内的总时间。

例如,如果一个补间动画的duration为2,并且重复了3次,totalTime的值在整个补间过程中将从0变为8(播放一次后再重复三次,总共四个周期),而time的值则会在每个周期中从0变为2,共四次。

此方法既可以作为获取器(getter)也可以作为设置器(setter)使用。省略参数将返回当前值(getter),而提供参数则会设置该值(setter)并返回实例本身以便更容易进行链式调用。

//gets current time
var currentTime = myTween.time();

//sets time, jumping to new value just like seek()
myTween.time(2);