FrontLaxWeb: 高级视差与交互式滚动 是做什么的?
此文件是“大脑”:方法论。配方和代码片段位于
plantillas/目录下,按需读取。路径plantillas/、references/、Designs/和Components/均相对于此文件所在的文件夹。
此技能实现的目标
将普通着陆页转变为 网页体验:滚动和指针成为连续动画的控制器。品牌无关:接收每个项目的颜色/令牌。
七大效果(目录)
- 平滑滚动(基础): Lenis。一切感觉高级的基础。
- 层叠视差: 慢速背景 / 快速前景 = 深度感。
- 滚动绑定动画: 属性绑定到滚动百分比。
- 滚动揭示: 进入视口时出现/动画。
- 粘性 / 固定: 某元素“粘住”的同时周围内容变化(如堆叠卡片)。
- 指针微交互: 3D 倾斜、自定义光标、悬停效果。
- 带弹性的手势: 拖放、点击:使用可中断的弹簧物理,而非固定持续时间的 CSS 过渡。见下方专属章节。
手势与弹簧(整合自 Emil Kowalski 的 apple-design 技能,提炼自 WWDC)
这是一个与上述滚动/视差 截然不同 的领域:涉及 触摸和拖拽 某物(如菜单、可滑动卡片、模态框、滑块)的物理特性。适用于 Web 的最可执行原则(源自 17 条原始原则;摘要见 references/recetas-y-matriz.md §4bis):
- 可中断性,17 条中最重要的: 任何动画必须能够在过渡中途被抓住并重新定向。对于用户可能 触摸 的一切,使用 弹簧(参数:
damping/阻尼 +response/速度),绝不要使用固定持续时间的 CSStransition:弹簧始终知道如何从其 当前 位置进行动画,而固定过渡则不能。 - 速度传递: 释放手势时,动画以手指的速度继续(不从零开始),从而避免视觉“接缝”。在 Motion 中:使用
dragMomentum以及来自PanInfo的velocity作为弹簧的初始速度。 - 橡皮筋效果: 在边界处,提供渐进阻力,绝不生硬停止。
- 空间一致性: 从右侧进入的面板应从右侧退出;将
transform-origin锚定到触发过渡的元素。 - 材质与深度: 浮动半透明层(
backdrop-filter: blur())提供视觉层次,绝不要直接堆叠两个半透明表面。无显卡时,轻量模式会移除模糊效果:其半透明背景必须在单独状态下也清晰可读。 - 交叉确认(非新配方):其“帧级平滑度”规则与我们已在 不可妥协的基础 中拥有的规则相同(仅限
transform/opacity):两个独立来源得出相同规则,增加对其的信心。 - 基础哲学(Apple 的 8 项基础): 目的、自主性、责任、熟悉度、灵活性、简洁、工艺、愉悦(是前 7 项正确的必然结果)。这是精神,而非可实施的技术:用于证明设计决策的合理性(“这是有目的还是噪音?”),而非作为技术检查清单。
✅ 解决了的张力。 Apple 的第 14 条原则(使用 prefers-reduced-motion: reduce,用淡入淡出替换运动)与我们内部策略(“为所有人呈现所有内容”,忽略该偏好)存在直接冲突。最终采用第三条路径:运动不会关闭,而是降低幅度。 第 14 条原则既未被丢弃也未被复制:它被纳入作为同一旋钮的一个极端情况(--motion-gain: 0 恰好产生一个只有淡入淡出的网页),因此无需为每个效果维护两个版本。完整机制见“内部运动策略”(下方专属章节)。
不可妥协的基础
- 性能: 仅对
transform和opacity(GPU)进行动画。绝不要使用top/left/width/height/margin。明智地使用will-change、requestAnimationFrame,并避免布局抖动。 - 无显卡,轻量模式: 每个网页天生具备软件渲染检测及其轻量模式(无 Lenis、无模糊或混合、3D 使用其非 3D 版本)。见下方专属章节。
- 内部运动策略: 在每个项目中都是 强制性 的。其专属章节就在下方,因为这是最容易因疏忽而违反的规则。
内部运动策略(强制性)
为所有人呈现所有内容,幅度恰到好处。 没有人看到死气沉沉的网页。根据访客的不同,变化的 不是 是否有运动,而是 多少 运动。一个单一旋钮控制整个网页:CSS 变量 --motion-gain,由 <head> 中的脚本设置在 <html> 元素上。
| 情况 | --motion-gain | 访客看到的内容 |
|---|---|---|
| 默认 | 1 | 完整体验。 |
系统偏好 prefers-reduced-motion: reduce | 0.25 | 相同设计,运动幅度四分之一:运动被理解为点缀,而非相机运动。 |
URL 含 ?motion=off | 0 | 所有自动运动保持静止,并移除 motion 类。访客用手指拖拽的内容仍会响应:无法滑动的可滑动卡片不是简洁界面,而是坏掉的图片。这是不需要运动的人的逃生阀,而非设计模式。 |
URL 含 ?motion=full | 强制为 1 | 忽略系统偏好。用于在禁用了 Windows 动画效果的设备上审查工作。 |
0.25 是内部默认值,可根据项目需要调整,但绝不能是 1:如果在启用 reduce 时没有任何变化,说明你没有应用该策略。
旋钮的三条规则
gain乘以 行程:像素、缩放、旋转、倾斜。对于连续效果(如跑马灯、循环),它乘以 速度。gain绝不 乘以不透明度。淡入淡出不会让任何人头晕。因此,当旋钮调低时,效果不会中断:它 降级。使用gain: 0.25的套娃式动画(matrioska)仍在讲述相同的故事,但以链接淡入淡出的形式而非镜头缩放。也正因如此,该策略不强制为每个效果编写第二个版本,而这正是第 14 条原则的成本所在。gain不会缩放用户驱动的运动:拖拽、悬停、指针倾斜、光标 lerp、手势弹簧。内耳不会对自身引起的运动感到不适。它仅缩放 非主动请求的 运动:视差、滚动缩放、套娃、序列擦洗、水平移动、速度倾斜、跑马灯。
并且始终,此外
4. 可见的逃生阀。 除了 ?motion=off 之外,还需在界面中提供一个可访问的控制(页脚即可)。仅存在于 URL 中的阀门无法被需要它的人找到。
5. 键盘焦点和锚点保持完整,且内容无需 JS 即可读(渐进增强)。
可访问性,严格验证(已验证通过 WCAG、MDN 和 web.dev,2026-08-19):
- 使此策略 符合标准 的并非旋钮本身,而是 逃生阀。WCAG 2.3.3(AAA 级)要求能够 禁用 运动,而不仅仅是减少运动;
?motion=off就是该机制,因此它既是强制的也是可发现的。一个仅缩小运动幅度而没有真正关闭功能的旋钮将不符合 2.3.3 的字面要求。 reduce下的0.25是一个 起点,而非绝对值。引起头晕的是大振幅运动(视差、缩放、大表面平移),而非不透明度或小位移。精细规则:在reduce下,这种大运动应降至约零或替换为淡入淡出,而非保留为“更小但存在”。对于 16px 的揭示效果,0.25足够了;对于 300px 的视差效果,0.25仍会引起头晕,需要进一步降低或直接使用不透明度。这正好符合 MDN 和 web.dev 的建议:“移除、减少或替换”。- WCAG 2.2.2 “暂停、停止、隐藏”(A 级,必选,非 AAA): 任何持续时间超过 5 秒的自动循环动画(跑马灯、背景视频、运动渐变)必须具有暂停或停止控制,而旋钮 不能 替代此要求。如果使用无限跑马灯,请为其单独设置暂停按钮。
中央开关(按原样复制到 <head> 中,位于任何动画 CSS 之前):
<script>
(function () {
var h = document.documentElement;
var q = new URLSearchParams(location.search).get('motion');
var reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
var gain = q === 'off' ? 0 : q === 'full' ? 1 : reduce ? 0.25 : 1;
h.style.setProperty('--motion-gain', String(gain));
h.classList.toggle('motion', gain > 0); // 兼容性:动画状态挂在 html.motion 上
})();
</script>
在 CSS 中,它用于 calc() 中;在 JS 中,读取一次并相乘:
const GAIN = parseFloat(getComputedStyle(document.documentElement)
.getPropertyValue('--motion-gain')) || 0;
无显卡:轻量模式(每新站默认)
情况说明。 在一台禁用硬件加速的电脑上(许多旧电脑或企业电脑都会出现这种情况),三个带有动画滚动的网页卡顿严重,而 cloudflare.com 却流畅运行。在 CPU 6x 且无显卡、分辨率 1920x1080 的条件下测量,统计到达屏幕的帧数:
| 网站 | 优化前 | 使用轻量模式 | cloudflare.com,同条件 |
|---|---|---|---|
| SaaS(Lenis、毛玻璃、3D) | 1.7 帧/秒,卡顿 2.4 秒 | 27.5 帧/秒,卡顿 0.13 秒 | 42.6 帧/秒,卡顿 47 毫秒 |
| 作品集(Lenis、模糊球体、3D) | 4.6 帧/秒,卡顿 372 毫秒 | 24.8 帧/秒,卡顿 84 毫秒 | 45.3 帧/秒,卡顿 49 毫秒 |
| 产品(无 Lenis;模糊云、叠加噪点、毛玻璃演示) | 30.1 帧/秒,卡顿 260 毫秒 | 42.6 帧/秒,卡顿 74 毫秒 | 46.5 帧/秒,卡顿 46 毫秒 |
配备显卡时,轻量模式不会启动,没有任何变化(在三者上逐像素验证过)。
原因何在。 没有显卡时,处理器承担了显卡的工作:模糊效果、混合模式、3D 以及合成每一帧。而使用 Lenis 时,滚动由 我们的 代码在每一帧移动:如果主线程只有 5 帧/秒,页面移动速度就是 5 帧/秒。浏览器的原生滚动由另一个线程控制,即使主线程繁忙也能保持流畅(这就是为什么 cloudflare.com 表现良好:其代码运行在 2 帧/秒,但屏幕刷新率是 86 帧/秒)。
1. 检测(plantillas/react/dibujoPorSoftware.ts 或 plantillas/vanilla/modo-ligero.js):使用 getContext("webgl2"|"webgl", { failIfMajorPerformanceCaveat: true }) 请求上下文;null 表示软件渲染。如果获取到上下文,立即释放(WEBGL_lose_context)。每次访问仅一次,且首次绘制之后,绝不在 LCP 之前。?ligero=1 强制启用,?ligero=0 强制禁用;在同源的 <iframe> 内,也会检查外部 URL。在 jsdom 和预渲染中,假定有显卡。
2. 仅在此情况下:
- (a) 不启动 Lenis:使用浏览器原生滚动,替代以具有相同外观的原生组件(使用
smooth模式的scrollTo,使用overflow: hidden在<html>上实现菜单的stop/start,on("scroll"),animatedScroll)。这仅由plantillas/react/useLenis.ts(以及原生版本的arrancarScroll())处理。锚点和菜单不需要各自带一个if判断。它不挂载在window.lenis上:Lenis 1.3 已将其数据存储在其中。 - (b)
<html data-ligero>以及plantillas/vanilla/modo-ligero.css中的 CSS:backdrop-filter: none;filter: blur()的光晕被替换为原本就模糊的radial-gradient(使用scale属性放大两倍,不会与视差的transform冲突);mix-blend-mode(如叠加噪点)被替换为具有更低不透明度的普通混合。视觉效果几乎相同,且运动方式保持不变。 - (c) 3D:网页中 每个
getContextWebGL 请求都使用failIfMajorPerformanceCaveat: true,因此它会自动回退到其非 3D 版本,该版本 必须存在(可以是图片、平面 Logo,或者如果只是背景装饰,则什么都不显示)。 - (d) 动画,不变。 内部策略不变:动画面向所有人,仅调整幅度,不关闭。并且已经测量过:在上述 SaaS 示例中,移除动画背景或暂停 CSS 动画对性能没有影响(从 28 提升到 29-30 帧/秒);在产品示例中,微粒和光束光晕也是如此。性能消耗来自 (a)、(b) 和 (c)。
3. 测量,而非猜测(plantillas/medir-scroll-visible.mjs,从包含 playwright-core 的文件夹运行):统计滚动驱动下到达屏幕的帧数(通过 Chrome 的屏幕输出),而非 requestAnimationFrame 回调的帧数,因为后者在原生滚动下会产生误导。始终进行两项测量,并始终以 cloudflare.com 作为同一轮测试的基准:SIN_GRAFICA=1 node medir-scroll-visible.mjs <url> 3 6(无显卡电脑)以及不带 SIN_GRAFICA 但 CPU 为 4x(普通笔记本)。Chrome 无头模式(如 Lighthouse 所用)使用显卡渲染:因此不适用于此项测试。要找出性能瓶颈,应逐一移除元素,使用注入的 CSS(display: none、filter: none、mix-blend-mode: normal)并重新测量:通过此方法找出了上表中产品网站的云朵效果(第一帧时间从 0.8 秒降至 0.35 秒)、其噪点效果和演示,并发现其首页的毛玻璃效果和微粒对性能没有影响。
带显卡的性能:任何动画滚动网页的五条规则
基于两个真实网站的测量值(其中一个网站,在 CPU 4x 的低帧率下,每帧工作量从 580 毫秒降至 355 毫秒)。 没有任何一条规则会停止或减慢动画:它们消除了看不见的工作。
- 不要在
animationend事件中使用getAnimations():这会强制重新计算整个页面的样式(在 4x CPU 下约 50 毫秒,且通常发生在滚动过程中)。应改用计数器跟踪元素的animationstart和animationend事件。 - 不要在滚动时暂停仅移动
transform/opacity的动画:这些动画由合成器处理,暂停并不会节省性能,而且暂停和恢复每次滚动都会导致两次较大的样式重新计算。 - 不要在进行滚动的同时“空闲时间”装载部分内容:Lenis 在帧与帧之间会留下空闲间隙,
requestIdleCallback恰好会在此期间调用。应等待滚动完全停止。 - 如果每帧的样式不发生变化,就不要在滚动过程中每帧都写入它们(例如,每次都将
--bn: 0写入每个幻灯片)。 - 避免在滚动期间修改
will-change:这会给合成器带来额外负担,并且可能导致不必要的提升/取消提升操作。
项目模架与文件结构
每个 FrontLaxWeb 项目应遵循以下结构:
README.md:项目文档。src/:源代码(React、Vanilla 等)。components/:可复用 UI 组件。hooks/:自定义 React Hooks。utils/:工具函数。styles/:样式文件(CSS、Tailwind 等)。
plantillas/:配方和代码片段。react/:React 相关模板(如useLenis.ts、dibujoPorSoftware.ts)。vanilla/:原生 JS 模板(如modo-ligero.js、modo-ligero.css)。
references/:参考文献和资源。Designs/:设计文件。Components/:可能包含独立的演示组件。public/:静态资源。
根据项目需求调整,但核心的 plantillas/、references/、Designs/ 和 Components/ 目录保持不变。
故障排除和常见问题
问:我的网站在某些设备上卡顿,即使采用了上述策略。
答:首先,确认轻量模式是否已激活(检查 <html data-ligero>)。如果已激活,请遵循“测量,而非猜测”部分中的步骤,使用 CSS 注入法逐步移除效果。如果未激活,请检查你是否正确使用了 getContext 和 failIfMajorPerformanceCaveat。
问:我应该使用 will-change 吗?
答:例如,对于滚动绑定动画、3D 倾斜或拖拽元素,可以明智地使用。但不要在所有元素上滥用,因为这可能消耗大量内存。仅在你知道将会有动画处理变换的元素上使用 will-change: transform。
问:如何将 --motion-gain 与 GSAP 结合使用?
答:使用 GSAP 的 useGSAP 钩子(对于 React)或标准 gsap.to(),并在计算动画值(如 x、y、scale、rotation)时乘以 GAIN 常量(通过 getComputedStyle 获得)。对于不透明度,不要乘以 GAIN。
问:我可以将此技能用于 Unity WebGL 游戏吗? 答:不,此技能专为基于 DOM 的网页体验设计,而非 Canvas/WebGL 游戏。不过,其运动策略原则(通过 CSS 变量进行幅度控制)仍可适用。