HyperFrames 的 CSS 动画
HyperFrames 可以通过其 css 运行时适配器来定位 CSS 关键帧动画。适用于简单的重复主题、背景动效、闪烁、发光、遮罩以及非序列化的装饰性动画。
对于场景编排,GSAP 通常更清晰。CSS 动画最适合那些属于单个元素且具有固定持续时间的动效。
契约
- 在运行时初始化完成前,将动画元素放入 DOM。
- 为时间控制元素设置
data-start值,使本地动画时间与剪辑匹配。 - 使用有限的
animation-duration和animation-iteration-count,因为负延迟回退方式无法在缺乏 WAAPI 支持的 CSS 动画环境中表示无限持续时间。 - 优先使用
animation-fill-mode: both,以便定位后的状态在动画激活前后都能保持。 - 避免使用基于真实时间的 JavaScript、悬停触发的状态以及依赖用户事件的类切换。
适配器会发现具有计算所得 animation-name 的元素,在可用时定位其浏览器的 Animation 句柄,并回退到使用负的 animation-delay 进行暂停。
基本模式
<div
id="pulse-ring"
class="clip pulse-ring"
data-start="0"
data-duration="4"
data-track-index="2"
></div>
<style>
.pulse-ring {
width: 280px;
height: 280px;
border: 4px solid rgba(255, 255, 255, 0.7);
border-radius: 50%;
animation-name: pulse-ring;
animation-duration: 1200ms;
animation-timing-function: cubic-bezier(0.2, 0, 0, 1);
animation-iteration-count: 3;
animation-fill-mode: both;
}
@keyframes pulse-ring {
from {
opacity: 0;
transform: scale(0.82);
}
35% {
opacity: 1;
}
to {
opacity: 0;
transform: scale(1.18);
}
}
</style>
交错模式
使用 CSS 自定义属性避免重复关键帧:
<div class="clip dots" data-start="1" data-duration="3" data-track-index="3">
<span style="--i: 0"></span>
<span style="--i: 1"></span>
<span style="--i: 2"></span>
</div>
<style>
.dots span {
display: inline-block;
width: 18px;
height: 18px;
margin-right: 10px;
border-radius: 50%;
background: currentColor;
animation: dot-pop 900ms ease-out both;
animation-delay: calc(var(--i) * 120ms);
}
@keyframes dot-pop {
from {
opacity: 0;
transform: translateY(18px) scale(0.75);
}
to {
opacity: 1;
transform: translateY(0) scale(1);
}
}
</style>
良好用途
- 具有已知重复次数的装饰性循环。
- 遮罩、发光、闪烁、颗粒和微妙的视差层。
- 简单的单元素入场动画,使用完整的 JS 时间线显得过于繁琐。
应避免
- 无限 CSS 动画,除非已验证浏览器暴露了可定位的 WAAPI 支持的 CSS 动画句柄。应优先使用覆盖可见持续时间的有限迭代次数。
- 在使用变换(transform)可行的场景中,对
top、left、width或height等布局属性进行动画。 - 依赖悬停、聚焦、滚动或媒体查询来触发渲染关键动效。
- 在启动后更改动画类,除非有其他确定性时间线控制这种更改。
验证
编辑 CSS 动画合成后:
npx hyperframes lint
npx hyperframes validate
致谢与参考
- HyperFrames 适配器源码:
packages/core/src/runtime/adapters/css.ts。 - MDN CSS 动画文档:https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/animation
- MDN
animation-fill-mode:https://developer.mozilla.org/en-US/docs/Web/CSS/animation-fill-mode