跳过主要内容

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);
无噪 Logo
无噪文档
中文文档 · 复刻官网
查看所有 ↗