totalTime
totalTime(time:Number, suppressEvents:Boolean):[Number | self]
根据播放头的位置进行获取或设置,这totalDuration
其中包含任何重复和重复延迟。
参数
time: 数值
(默认值 =
NaN
) - 如果省略参数,则返回当前值(getter);而如果定义了参数,则会设置该值(setter),并返回实例本身以便更容易进行链式调用。负值将从动画的结束位置开始解释。动画的持续时间。suppressEvents:布尔值
(默认值 =
false
) - 如果true
当时间轴移动到由time
参数。
返回值:[数字 | 自身实例]
省略参数将返回当前值(getter),而定义参数将设置值(setter)并返回实例本身以便于链式调用。
细节
根据播放头的位置进行获取或设置,这totalDuration
其中包括任何重复(repeats)和重复延迟(repeatDelays)例如,如果某个补间动画的duration
持续时间为 2 并且重复repeat
为3,totalTime
的值在整个补间过程中将从0变为8(播放一次后再重复三次,总共四个周期),而time
的值将在0到2之间总共变化4次。如果你添加了一个repeatDelay
为1,则totalTime
将在补间过程中从0变化到11。
此方法既可以作为获取器(getter)也可以作为设置器(setter)使用。省略参数将返回当前值(getter),而提供参数则会设置该值(setter)并返回实例本身以便更容易进行链式调用。
totalTime
的值永远不会超过totalDuration
,也不会小于0(数值将被适当地裁剪)。负值将从动画的结束位置开始解释。开始计算。例如,-2表示动画结束前两秒。如果该动画的totalDuration
为6,并且你执行了tl.totalTime(-2)
,它会跳转至totalTime
为4的位置。
//gets total time
var totalTime = tl.totalTime();
//sets total time, jumping to new value just like seek()
tl.totalTime(2); .