跳转到内容

配置选项

Rinne 提供了丰富的配置选项,用于精细控制动画的行为。

当你调用 rinne.to()tl.to() 时,可以传入以下配置:

  • duration: 动画持续时间(毫秒)。默认为 1000
  • delay: 动画开始前的延迟时间(毫秒)。默认为 0
  • ease: 缓动函数。支持字符串(如 'expo.out', 'sine.inOut')或自定义函数 (t: number) => number
  • additive: 是否开启叠加模式。默认为 true
  • commit: 动画结束时,是否将最终产生的位移永久合并到目标的物理基础状态(Base)中。
  • repeat: 重复播放次数。0 表示播放一次,1 表示重复一次(共播放两次),-1 表示无限循环。
  • yoyo: 是否开启往返播放。开启后,偶数次重复将反向播放。
  • stagger: 交错动画设置。可以是简单的数字(每个元素延迟多少毫秒),或者是复杂的对象:
    {
    amount: 1000,
    from: 'center', // 'start', 'end', 'center', 'edges', 'random'
    grid: [rows, cols],
    axis: 'x' // 'x' 或 'y'
    }
  • onStart: 动画开始时触发。
  • onUpdate: 每一帧更新时触发,接收当前的进度 p (0-1)。
  • onComplete: 动画完全结束时触发。

通过 rinne.timeline(config) 创建时间轴时支持:

  • repeat: 整个时间轴的循环次数。
  • yoyo: 整个时间轴是否往返播放。