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
或者repeatDelay
而totalProgress()
包括。
例如,如果一个时间轴实例被设置为重复一次,在第一次循环结束时,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);