Skip to content

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

进度(progress)

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

此方法既作为获取器也作为设置器。省略参数时返回当前值(获取器),而定义参数则设置该值(设置器),并返回实例本身以便于链式调用,如 tl.progress(0.5).play();

方法签名

plaintext
progress(value: Number): [Number | self]

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

参数(Parameters)

  • value: Number(可选)
    • 设置时间线的进度值,范围在0到1之间。

返回值(Returns)

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

示例代码(Example Code)

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

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

🎉有任何问题,欢迎联系我

WeChat QR Code
WeChat
QQ QR Code
QQ

赣ICP备2023003243号