totalDuration
totalDuration(value:Number):[Number | self]
获取或设置时间轴的总持续时间(包括任何重复和重复延迟)以秒为单位。
参数
值: 数值
(默认值 =
NaN
) - 如果省略参数,则返回当前值(getter);而如果定义了参数,则会设置该值(setter),并返回实例本身以便更容易地进行链式调用。负值将被解释为从结尾开始倒数。结束位置开始解释。动画的持续时间。
返回值:[数字 | 自身实例]
省略参数将返回当前值(getter),而定义参数将设置值(setter)并返回实例本身以便于链式调用。
细节
获取或设置时间轴的总持续时间(包括任何重复和重复延迟)以秒为单位。duration
相比之下,它会非包含重复(repeats)和重复延迟(repeatDelays)。例如,如果补间动画的duration
持续时间为10秒,repeat
重复次数为1次,且repeatDelay
重复延迟为2秒,则总持续时间totalDuration
将是22秒。
由于时间轴的持续时间由其内容决定,因此将此方法用作设置器时,只会导致timeScale
被调整以使其当前内容适应指定的 totalDuration,但 totalDuration(和 duration)本身的值将保持不变。
此方法既可以作为获取器(getter)也可以作为设置器(setter)使用。省略参数将返回当前值(getter),而提供参数则会设置该值(setter)并返回实例本身以便更容易进行链式调用。
//gets total duration
var total = tl.totalDuration();
//adjusts the timeScale of the timeline so that it fits into exactly 10 seconds on its parent timeline
tl.totalDuration(10);