progress(进度)
progress(进度)(value:Number, suppressEvents:Boolean):[Number | self]
[覆盖] 获取或设置时间轴的进度,其值范围为 0 到 1,表示虚拟播放头的位置(不包括重复),其中 0 是起点,0.5 是一半完成状态,1 是完成。
参数
值: 数值
(默认值 =
NaN
) - 如果省略参数,则返回当前值(getter);如果提供参数,则设置值(setter),并返回实例自身以方便链式调用。suppressEvents:布尔值
Boolean
(默认值 =false
)- 如果true
,当播放头移动到新位置时,不会触发任何事件或回调。
返回值:[数字 | 自身实例]
省略参数将返回当前值(getter),而定义参数将设置值(setter)并返回实例本身以便于链式调用。
细节
获取或设置时间轴的进度,该进度是一个介于 0 和 1 之间的值,表示虚拟播放头的位置(不包括重复部分),其中 0 表示在开头,0.5 表示完成一半,1 表示完成。repeat
被定义,则 progress 和totalProgress
将会不同,因为progress
不包含任何重复或重复延迟,而totalProgress
也是如此。例如,如果一个时间轴实例被设置为重复一次,在第一次循环结束时totalProgress
将只有 0.5,而progress
将是 1。如果你在整个动画过程中观察这两个属性,你将看到 progress 的值从 0 到 1 运行两次(每个循环一次),而这在与totalProgress
从 0 到 1 只运行一次所需的时间相同。
此方法同时具备 getter 和 setter 的功能。省略参数时返回当前值(getter),而传入参数时则设置值(setter)并返回实例自身以便于链式调用,例如:tl.progress(0.5).play();
//gets current progress
var progress = tl.progress();
//sets progress to one quarter finished
tl.progress(0.25);