根据父时间线的本地时间返回动画结束的时间。
根据父时间线的本地时间返回动画结束的时间。(type:String, callback:Function, params:Array):[Function | self]
eventCallback"onComplete", "onUpdate", "onStart"
获取或设置一个事件回调,例如"onRepeat"
或或以及应传递给该回调的任何参数。
参数
type:字符串
事件回调的类型,例如
"onComplete", "onUpdate", "onStart"
获取或设置一个事件回调,例如"onRepeat"
。这是区分大小写的。callback: 函数
(默认值 =
null
) - 当事件发生时应该调用的函数。参数: 数组
(默认值 =
null
) - 要传递给回调函数的参数数组。
返回值:[函数 | 自身实例]
如果只传入第一个参数则返回当前值(getter),而如果传入超过第一个参数,则会设置回调函数(setter)并返回实例自身以方便链式调用。
细节
eventCallback"onComplete"
, "onUpdate"
, "onStart"
, "onReverseComplete"
, "onInterrupt"
,或者"onRepeat"
以及应当传递给该回调函数的任何参数。这等同于在构造函数中的vars
参数中直接定义这些值,因此以下两行功能是相同的:
//the following two lines produce IDENTICAL results for onComplete behavior:
gsap.to(obj, {
duration: 1,
x: 100,
onComplete: myFunction,
onCompleteParams: ['param1', 'param2']
});
myAnimation.eventCallback('onComplete', myFunction, ['param1', 'param2']);
使用eventCallback()
的好处在于它允许你即使在动画实例创建之后也能设置回调函数,之后并且还可以检查回调引用,甚至可以在运行时动态删除它们(使用null
来删除事件回调)。
//deletes the onUpdate
myAnimation.eventCallback('onUpdate', null);
每种事件类型只能关联一个回调函数(一个onComplete
,一个onUpdate
,一个onStart
等等)。因此,设置新的值将覆盖旧的值。所有这些值也会填充到vars
对象中,此对象最初被传递给了构造函数(可以将其视为配置数据的存储区域)。
此方法同时具备 getter 和 setter 的功能。只省略除第一个参数外的所有参数将返回当前值(getter),而如果提供了除第一个参数之外的其他参数,则会设置值(setter)并返回实例本身以便更容易进行链式调用,例如
myAnimation
.eventCallback('onComplete', completeHandler)
.eventCallback('onUpdate', updateHandler, ['param1'])
.play(1);