SuperAPI AI 工具集

gsap-utils

通用与其它

查看项目

更新于 10-16 01:37

技能介绍

用途:gsap.utils 是 GSAP 提供的纯辅助函数集合,无需注册,可在补间变量、ScrollTrigger 或 Observer 回调以及任何驱动 GSAP 的 JS 中使用,用于数学计算、数组/集合处理、单位解析和数值映射(如把滚动位置映射为动画值、随机化、吸附到网格、归一化输入)。

主要能力:clamp 限制数值范围;mapRange 区间映射;normalize 归一化到 0–1;interpolate 在数值、颜色、对象间插值;random 生成随机数或从数组取值,可带吸附步长;snap 吸附到倍数或数组最近值;shuffle 打乱数组;distribute 按索引或网格分配值;getUnit/unitize 处理单位;splitColor 拆分颜色;selector 返回作用域选择器;toArray 转为数组;pipe 组合函数;wrap/wrapYoyo 循环取值。

使用方式:多数函数把待处理值作为最后一个参数,省略该参数即返回可复用函数,例如 gsap.utils.clamp(0, 100)(150)。random 例外,需传 true 作为最后参数才返回函数。可在补间中直接写字符串形式如 "random(-100, 100, 5)"。

适用场景:滚动映射、进度转角度、网格或步进动画、随机排序、组件内作用域选择器、颜色分量动画等。

限制:mapRange 与 normalize 只处理数字,不处理单位,涉及单位时需配合 getUnit/unitize;应遵循官方文档 API,不依赖未记录行为。更多内容见 https://gsap.com/docs/v3/HelperFunctions。