默认值
在同一个 glaze() 调用中配置引擎,并一次性应用默认值。元素自身的工具类会覆盖匹配的默认值。
元素默认值
不带状态限定的属性会应用于每个现有的 from 或 to 动画状态:
TypeScript
glaze({
lib: { gsap: { core: gsap } },
defaults: { element: "duration-1|ease-power2.inOut" },
})
HTML
<!-- Uses a one-second duration and the default easing. -->
<div data-animate="from:opacity-0"></div>
<!-- Explicit values win over defaults. -->
<div data-animate="from:opacity-0|duration-0.5"></div>
特定状态的默认值仅应用于该状态:
TypeScript
defaults: {
element: "duration-1 from:opacity-0 to:ease-linear",
}
to 动画会接收通用时长和 to 缓动,但不会添加 from 状态。默认值绝不会创建元素未请求的动画状态。对于 from/to 动画,通用默认值会应用于两个状态,然后应用特定状态的默认值,最后应用元素显式指定的值。
较旧的 elementSettings 配置键仍是通用默认值的别名。在新代码中优先使用 element;如果两者指定了相同的值,则以 element 为准。
时间轴默认值
使用 defaults.tl 为每条时间线配置设置:
TypeScript
glaze({
lib: { gsap: { core: gsap } },
defaults: {
tl: "defaults:ease-power2.inOut|duration-1",
},
})
Glaze 会为独立的动画元素也创建时间线。defaults: 下的值会传递给引擎的时间线默认值。元素属性仍具有更高优先级。时间线自身的设置会覆盖已配置的值,同时保留未被替换的默认值。
时间线设置使用冒号表示嵌套属性:
TypeScript
defaults: {
tl: "defaults:duration-1 scrollTrigger:trigger-[&]",
}
此处的 [&] 会解析为时间轴所属的元素。ScrollTrigger 需要 GSAP 和一个已注册的 插件ScrollTrigger。Motion 适配器会明确拒绝仅 GSAP 的设置。