根据父时间线的本地时间返回动画结束的时间。
根据父时间线的本地时间返回动画结束的时间。(type:String, callback:Function, params:Array):[Function | self]
eventCallbackonComplete
, onUpdate
, onStart
, onReverseComplete
,或者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);
```