Skip to content

GSAP中文文档 - timeline 方法 - 时间缩放(timeScale)

时间缩放(timeScale)

timeScale 方法用于获取或设置动画的时间缩放因子,其中 1 表示正常速度(默认值),0.5 表示速度减半,2 表示速度加倍,-1 表示以正常速度反向播放等。例如,如果一个动画的 duration 是 2,但其 timeScale 是 0.5,那么它将需要 4 秒才能完成。如果你将该动画嵌套在一个 timeScale 也是 0.5 的时间轴中,它将需要 8 秒才能完成。你甚至可以对 timeScale 进行补间动画,以逐渐减慢或加快速度。

方法签名

plaintext
timeScale(value: Number): self

获取或设置动画的时间缩放因子。

参数(Parameters)

  • value: Number
    • 要设置的时间缩放因子。

返回值(Returns)

  • self
    • 返回实例本身,便于链式调用。

详细信息(Details)

  • 如果省略参数,timeScale() 方法将返回当前值(getter)。
  • 如果定义了参数,它将设置值(setter),并返回实例本身以便于链式调用,如 myAnimation.timeScale(2).play(1);

示例代码(Example Code)

javascript
// 获取当前时间缩放因子
var currentTimeScale = tl.timeScale()

// 将时间缩放因子设置为半速
tl.timeScale(0.5)

赣ICP备2023003243号