GSAP中文文档 - timeline 属性 - 配置对象（vars）

配置对象（vars）

通过构造函数传递给原始时间线的配置对象，如 gsap.timeline({onComplete: func});

详细信息（Details）

vars 对象包含您希望时间线拥有的所有属性/值。

属性	类型	描述
autoRemoveChildren	Boolean	如果设置为 true，则子补间/时间线完成后将自动被杀死/移除。默认为 false，除了根时间线。
callbackScope	Object	所有回调（onStart, onUpdate, onComplete 等）使用的作用域。作用域是回调内部 this 引用的对象。
defaults	Object	设置默认值，这些默认值会被子动画继承。详见 "defaults" 部分。
delay	Number	动画开始前的延迟时间，以秒为单位。
onComplete	Function	动画完成时调用的函数。
onCompleteParams	Array	传递给 onComplete 函数的参数数组。例如，gsap.timeline({onComplete: myFunction, onCompleteParams: ["param1", "param2"]});。
onInterrupt	Function	动画被中断时调用的函数。注意，如果动画正常完成，则不会触发此事件。
onInterruptParams	Array	传递给 onInterrupt 函数的参数数组。例如，gsap.to(".class", {x:100, onInterrupt:myFunction, onInterruptParams:["param1", "param2"]});。
onRepeat	Function	动画每次重复时调用的函数。
onRepeatParams	Array	传递给 onRepeat 函数的参数数组。例如，gsap.timeline({onRepeat: myFunction, onRepeatParams: ["param1", "param2"]});。
onReverseComplete	Function	动画从反向到达开始时调用的函数。例如，如果调用了 reverse()，则补间会向开始移动，当其 time 达到 0 时，onReverseComplete 将被调用。
onReverseCompleteParams	Array	传递给 onReverseComplete 函数的参数数组。例如，gsap.timeline({onReverseComplete: myFunction, onReverseCompleteParams: ["param1", "param2"]});。
onStart	Function	动画开始时调用的函数（当其 time 从 0 变为其他值时，如果补间多次重启，可能会发生多次）。
onStartParams	Array	传递给 onStart 函数的参数数组。例如，gsap.timeline({onStart: myFunction, onStartParams: ["param1", "param2"]});。
onUpdate	Function	动画每次更新时调用的函数（在动画活动期间的每一帧）。
onUpdateParams	Array	传递给 onUpdate 函数的参数数组。例如，gsap.timeline({onUpdate: myFunction, onUpdateParams: ["param1", "param2"]});。
paused	Boolean	如果为 true，则动画将在创建后立即暂停。
repeat	Number	动画在第一次迭代后应重复的次数。例如，如果 repeat 是 1，则动画将总共播放两次（初始播放加上1次重复）。要无限重复，请使用 -1。repeat 应始终为整数。
repeatDelay	Number	重复之间的时间，以秒为单位。例如，如果 repeat 是 2 且 repeatDelay 是 1，则动画将首先播放，然后等待1秒再重复，然后再次播放，然后再等待1秒再进行最后一次重复。
repeatRefresh	Boolean	设置 repeatRefresh: true 会导致重复时间线在每次完整迭代（不包括悠悠）时 invalidate() 其所有子补间，并在内部重新记录它们的起始/结束值。这在您使用动态值（相对的、随机的或基于函数的）时很有用。例如，x: "random(-100, 100)" 将在每次重复时获得一个新的随机 x 值。duration、delay 和 stagger 不会刷新。
smoothChildTiming	Boolean	控制子动画是否自动重新定位（更改它们的 startTime）以在运行时更改属性时保持平滑播放。例如，想象时间线的播放头在一个孩子补间上，该补间完成了 75%，移动元素的左边从 0 到 100，然后调用该补间的 reverse() 方法。如果 smoothChildTiming 是 false（默认值，除了全局时间线外），补间将在原地翻转，保持其 startTime 一致。因此，时间线的播放头现在将在补间的 25% 完成点而不是 75%。详见 "时间线如何工作？" 部分。
yoyo	Boolean	如果为 true，则每隔一次重复周期将朝相反方向运行，使补间看起来来回移动（先前然后后）。这不会直接影响 reversed 属性。所以如果 repeat 是 2 且 yoyo 是 false，它看起来像：开始 - 1 - 2 - 3 - 1 - 2 - 3 - 1 - 2 - 3 - 结束。但如果 yoyo 是 true，它看起来像：开始 - 1 - 2 - 3 - 3 - 2 - 1 - 1 - 2 - 3 - 结束。