view-timeline 不能直接设置 opacity 变化,它仅定义滚动驱动的时间轴,需配合 @keyframes 和 animation-timeline 使用;仅 Chromium 115+ 支持,Firefox/Safari 不支持;必须用 animation-range 指定触发范围,否则动画瞬时完成;无 CSS 原生降级机制,需 JS 检测并回退到 IntersectionObserver。

直接用 view-timeline 实现“元素进入可视区渐入”目前不可行——它不能单独触发动画,必须配合 @keyframes 和 animation-timeline 使用,且仅支持 Chromium 115+(含 Edge),Firefox 和 Safari 完全不支持。
为什么 view-timeline 不能直接写 opacity: 0 → 1?
它本身只是定义一个时间轴(timeline),不是动画控制器。你得先声明 timeline,再把某个 CSS 动画绑定到它上面,靠滚动位置驱动关键帧进度。
常见错误现象:view-timeline: --tl element; 写了但没动效 → 忘了配 animation-timeline,或没定义对应 @keyframes。
-
view-timeline必须写在目标元素上(或其祖先),且需指定名称(如--tl)和范围(element表示以该元素自身为观测目标) - 绑定的
@keyframes必须用animation-timeline: --tl关联,否则 timeline 不生效 - 关键帧中的
offset值是相对于 timeline 起止点的归一化进度(0% = 进入视口开始,100% = 完全离开视口结束),不是滚动距离像素值
最简可用代码结构(Chromium only)
以下实现:元素顶部触达视口顶部时开始淡入,底部离开视口底部时完成淡入(即整个元素完全可见时 opacity=1):
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
立即学习“前端免费学习笔记(深入)”;
.fade-in {
view-timeline: --tl element;
animation: fade 1s linear;
animation-timeline: --tl;
animation-range: entry 0% exit 100%;
}
@keyframes fade {
from { opacity: 0; }
to { opacity: 1; }
}
注意:animation-range: entry 0% exit 100% 是关键——它把 timeline 的 0% 映射到“元素顶部进入视口”,100% 映射到“元素底部离开视口”。如果不写这行,动画默认按 timeline 全程(entry 0% → exit 0%)播放,几乎瞬间完成。
-
entry/exit是内置 phase,也可用cover(元素完全在视口内)、contain(视口完全包含元素)等 -
animation-range支持偏移,例如entry 20% exit 80%可让动画提前开始、延后结束 - 若想“刚露头就启动动画”,用
entry 0%;若想“完全可见才开始”,改用cover 0%
兼容性 fallback 怎么做?
没有原生 fallback 机制。@supports 可检测 view-timeline,但无法优雅降级到 IntersectionObserver —— 因为后者需 JS 注册监听,CSS 无权调用。
- 服务端可判断 UA,对非 Chromium 用户直接输出传统 class + JS 驱动动画
- 前端可运行时检查:
if ('viewTimeline' in CSS),再动态加类或初始化 IO - 不要依赖
@supports (view-timeline: --t element)做样式切换,它只控制 CSS 解析,不阻止 JS 执行 - 当前(2024 年中)Safari 技术预览版仍无
view-timeline计划,别指望短期跨浏览器
真正麻烦的是 timeline 的相位语义:entry/exit 指的是元素边界与视口边界的交点,不是“是否在视口中”,同一个元素在不同滚动方向下 entry 和 exit 触发顺序还可能变化。实际项目里建议先用 console.log 打印 IO 的 isIntersecting 对齐行为,再迁移到 view-timeline。

















