Skip to content

GSAP中文文档 - timeline 方法 - 开始时间(startTime)

开始时间(startTime)

startTime 方法用于获取或设置动画在其父时间轴上开始的时间(在定义的任何 delay 之后)。例如,如果一个补间动画恰好在其所放置的时间轴的3秒处开始,那么该补间动画的 startTime 将是3。

方法签名

plaintext
startTime(value: Number): self

获取或设置动画在其父时间轴上的开始时间。

参数(Parameters)

  • value: Number
    • 要设置的开始时间(秒数)。

返回值(Returns)

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

详细信息(Details)

  • 如果省略参数,startTime() 方法将返回当前的开始时间(getter)。
  • 如果定义了参数,它将设置开始时间(setter),并返回实例本身以便于链式调用。

如果父时间轴的 smoothChildTiming 属性为 true,并且在运行时进行了依赖时间的更改(例如调用 reverse() 或更改 timeScale() 等),startTime 可能会自动调整,以使时间看起来无缝。有关更多详细信息,请参见时间轴的 smoothChildTiming 属性文档。

示例代码(Example Code)

javascript
// 获取当前开始时间
var start = tl.startTime()

// 设置开始时间为2秒
tl.startTime(2)

赣ICP备2023003243号