GSAP中文文档 - tween 方法 - 时间(time)
时间(time)
省略参数时返回当前值(获取器),而定义参数则设置该值(设置器),并返回实例本身以便于链式调用。
获取或设置播放头的本地位置(基本上是当前时间),不包括任何重复或重复延迟。如果补间有一个非零的 repeat
,即使 totalTime
继续线性前进(或者如果 yoyo
是 true
,time
在前进和后退之间交替),其 time
在重复时会回到零。time
永远不会超过持续时间,而 totalTime
反映了包括任何重复和重复延迟在内的总时间。
例如,如果一个补间有一个持续时间为2和重复3次,totalTime
在补间的整个过程中将从0变化到8(播放一次然后重复3次,总共4个周期),而 time
将总共4次从0变化到2。
此方法既作为获取器也作为设置器。省略参数时返回当前值(获取器),而定义参数则设置该值(设置器),并返回实例本身以便于链式调用。
参数(Parameters)
- value: Number(可选)
- 设置补间的当前时间。
返回值(Returns)
- Number
- 如果未提供参数,返回当前时间。
- self
- 如果提供了参数,返回实例本身以便于链式调用。
示例代码(Example Code)
javascript
// 获取当前时间
var currentTime = myTween.time()
// 设置时间,跳转到新值,就像 seek() 一样
myTween.time(2)