跳过主要内容

totalProgress

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

[覆盖] 获取或设置时间轴的总体进度,其值介于0到1之间,表示虚拟播放头的位置(包括重复),0表示开始,0.5表示一半进度,1表示结束(完成)。

参数

  • : 数值

    (默认值 =NaN) - 如果省略参数,则返回当前值(getter);如果提供参数,则设置值(setter),并返回实例自身以方便链式调用。

  • suppressEvents:布尔值

    (默认值 =true) - 如果true,当播放头移动到新位置时,不会触发任何事件或回调。

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

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

细节

获取或设置时间轴的总进度,该值介于 0 到 1 之间,表示虚拟播放头的位置(包含重复和重复延迟)。包含重复和重复延迟),其中 0 表示开始位置,0.5 表示中间位置,1 表示结束(完成)。如果时间轴设置了非零的repeat已定义,progress()totalProgress()将会不同,因为progress()不包括repeat或者repeatDelaytotalProgress()包括。

例如,如果一个时间轴实例被设置为重复一次,在第一次循环结束时,totalProgress()将只有 0.5,而progress的值将是 1。如果你在整个动画过程中观察这两个属性的变化,你会发现progress在与之相同的时间内从 0 到 1 变化两次(每个循环各一次)totalProgress()从 0 到 1 只运行一次所需的时间相同。

此方法同时具备 getter 和 setter 的功能。省略参数时返回当前值(getter),而传入参数时则设置值(setter)并返回实例自身以便于链式调用,例如:tl.totalProgress(0.5).play();

//gets total progress
var progress = tl.totalProgress();

//sets total progress to one quarter finished
tl.totalProgress(0.25);
无噪 Logo
无噪文档
中文文档 · 复刻官网
查看所有 ↗