Skip to content

GSAP中文文档 - tween 方法 - 进度(progress)

进度(progress)

省略参数时返回当前值(获取器),而定义参数则设置该值(设置器),并返回实例本身以便于链式调用。

获取或设置补间的进度,这是一个介于0和1之间的值,表示虚拟播放头的位置(不包括重复),其中0是开始,0.5是完成一半,1是完成。如果补间定义了一个非零的 repeat,则进度和 totalProgress 将会不同,因为 progress 不包括任何重复或重复延迟,而 totalProgress 包括。例如,如果一个补间实例设置为重复一次,在第一个周期结束时 totalProgress 只会是0.5,而 progress 会是1。如果您观察整个动画过程中的这两个属性,您会看到进度从0到1两次(每个周期一次),而 totalProgress 从0到1一次。

参数(Parameters)

  • value: Number
    • 可选参数,设置补间的进度值,范围在0到1之间。

返回值(Returns)

  • Number
    • 如果未提供参数,返回当前进度值。
  • self
    • 如果提供了参数,返回实例本身以便于链式调用。

示例代码(Example Code)

javascript
// 获取当前进度
var progress = myTween.progress()

// 将进度设置为完成四分之一
myTween.progress(0.25)

赣ICP备2023003243号