跳过主要内容

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