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);