Communitygithub.com

FrontLaxWeb: 高级视差与交互式滚动

为着陆页和网页设计视差、交互式滚动、微交互和高级手势,支持 React(Motion + Lenis)和纯 HTML/CSS/JS(GSAP + Lenis)。用于创建或优化 Hero 区域、滚动绑定效果、视口进入揭示、粘性/堆叠卡片、平滑滚动、3D 倾斜、带弹性的拖放、可中断菜单和模态框,或任何应感觉像用户用滚动、鼠标或手指控制的“交互式视频”的网页,始终保持快速(60fps),无需显卡(默认轻量模式),并遵循内部策略:动画向所有访客展示,调整运动幅度而非关闭(通过 --motion-gain 旋钮,以及 ?motion=off 开关)。

FrontLaxWeb: 高级视差与交互式滚动 是什么?

FrontLaxWeb 是一个专业的 AI 技能,用于创建具有高级视差、交互式滚动和微交互的沉浸式网页体验。它支持 React(使用 Motion 和 Lenis)和原生 HTML/CSS/JS(使用 GSAP 和 Lenis),涵盖七个核心效果:平滑滚动、层叠视差、滚动驱动动画、视口揭示、粘性/固定效果、指针微交互和带弹性的手势。其独特之处在于强制的运动策略:动画向所有访客展示,但通过 CSS 变量 `--motion-gain` 调整幅度,而非直接关闭。该变量支持四个级别:默认(1)、系统减少运动偏好(0.25)、通过 URL 参数 `?motion=off` 完全关闭(0,但用户手势仍响应),以及用于测试的 `?motion=full`(强制为 1)。策略还包括内置的轻量模式,无需显卡即可运行,通过检测软件渲染并自动禁用 Lenis、模糊效果和 3D,同时保持动画流畅。该技能集成了来自 Emil Kowalski 的 Apple 设计原则,特别是可中断弹簧动画,确保任何可通过触摸或手势交互的元素始终使用弹簧物理,而非固定持续时间的 CSS 过渡,从而实现平滑、自然的交互。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mun1to/FrontLaxWeb/tree/main

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

FrontLaxWeb: 高级视差与交互式滚动 是做什么的?

此文件是“大脑”:方法论。配方和代码片段位于 plantillas/ 目录下,按需读取。路径 plantillas/、references/、Designs/ 和 Components/ 均相对于此文件所在的文件夹。

此技能实现的目标

将普通着陆页转变为 网页体验:滚动和指针成为连续动画的控制器。品牌无关:接收每个项目的颜色/令牌。

七大效果(目录)

  1. 平滑滚动(基础): Lenis。一切感觉高级的基础。
  2. 层叠视差: 慢速背景 / 快速前景 = 深度感。
  3. 滚动绑定动画: 属性绑定到滚动百分比。
  4. 滚动揭示: 进入视口时出现/动画。
  5. 粘性 / 固定: 某元素“粘住”的同时周围内容变化(如堆叠卡片)。
  6. 指针微交互: 3D 倾斜、自定义光标、悬停效果。
  7. 带弹性的手势: 拖放、点击:使用可中断的弹簧物理,而非固定持续时间的 CSS 过渡。见下方专属章节。

手势与弹簧(整合自 Emil Kowalski 的 apple-design 技能,提炼自 WWDC)

这是一个与上述滚动/视差 截然不同 的领域:涉及 触摸和拖拽 某物(如菜单、可滑动卡片、模态框、滑块)的物理特性。适用于 Web 的最可执行原则(源自 17 条原始原则;摘要见 references/recetas-y-matriz.md §4bis):

  • 可中断性,17 条中最重要的: 任何动画必须能够在过渡中途被抓住并重新定向。对于用户可能 触摸 的一切,使用 弹簧(参数:damping/阻尼 + response/速度),绝不要使用固定持续时间的 CSS transition:弹簧始终知道如何从其 当前 位置进行动画,而固定过渡则不能。
  • 速度传递: 释放手势时,动画以手指的速度继续(不从零开始),从而避免视觉“接缝”。在 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: reduce0.25相同设计,运动幅度四分之一:运动被理解为点缀,而非相机运动。
URL 含 ?motion=off0所有自动运动保持静止,并移除 motion 类。访客用手指拖拽的内容仍会响应:无法滑动的可滑动卡片不是简洁界面,而是坏掉的图片。这是不需要运动的人的逃生阀,而非设计模式。
URL 含 ?motion=full强制为 1忽略系统偏好。用于在禁用了 Windows 动画效果的设备上审查工作。

0.25 是内部默认值,可根据项目需要调整,但绝不能是 1:如果在启用 reduce 时没有任何变化,说明你没有应用该策略。

旋钮的三条规则

  1. gain 乘以 行程:像素、缩放、旋转、倾斜。对于连续效果(如跑马灯、循环),它乘以 速度。
  2. gain 绝不 乘以不透明度。淡入淡出不会让任何人头晕。因此,当旋钮调低时,效果不会中断:它 降级。使用 gain: 0.25 的套娃式动画(matrioska)仍在讲述相同的故事,但以链接淡入淡出的形式而非镜头缩放。也正因如此,该策略不强制为每个效果编写第二个版本,而这正是第 14 条原则的成本所在。
  3. 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:网页中 每个 getContext WebGL 请求都使用 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 毫秒)。 没有任何一条规则会停止或减慢动画:它们消除了看不见的工作。

  1. 不要在 animationend 事件中使用 getAnimations():这会强制重新计算整个页面的样式(在 4x CPU 下约 50 毫秒,且通常发生在滚动过程中)。应改用计数器跟踪元素的 animationstart 和 animationend 事件。
  2. 不要在滚动时暂停仅移动 transform/opacity 的动画:这些动画由合成器处理,暂停并不会节省性能,而且暂停和恢复每次滚动都会导致两次较大的样式重新计算。
  3. 不要在进行滚动的同时“空闲时间”装载部分内容:Lenis 在帧与帧之间会留下空闲间隙,requestIdleCallback 恰好会在此期间调用。应等待滚动完全停止。
  4. 如果每帧的样式不发生变化,就不要在滚动过程中每帧都写入它们(例如,每次都将 --bn: 0 写入每个幻灯片)。
  5. 避免在滚动期间修改 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 变量进行幅度控制)仍可适用。

相关技能