跳过主要内容

根据父时间线的本地时间返回动画结束的时间。

根据父时间线的本地时间返回动画结束的时间。(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);
```
无噪 Logo
无噪文档
中文文档 · 复刻官网
查看所有 ↗