跳过主要内容

progress(进度)

progress(进度)(value:Number, suppressEvents:Boolean):[Number | self]

[覆盖] 获取或设置补间的进度,这是一个介于0和1之间的值,表示虚拟播放头的位置(不包括重复),其中0为开始位置,0.5为完成一半,1为完成。

参数

  • : 数值

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

  • suppressEvents:布尔值

    (默认值 =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)并返回实例自身以便于链式调用,例如:myTween.progress(0.5).play();

//gets current progress
var progress = myTween.progress();

//sets progress to one quarter finished
myTween.progress(0.25);

如果你正在寻找经过缓动处理的缓动值,请查看比例属性。

无噪 Logo
无噪文档
中文文档 · 复刻官网
查看所有 ↗