FrontLaxWeb: 패럴랙스 및 프리미엄 인터랙티브 스크롤
이 파일은 '두뇌'입니다: 방법론입니다. 레시피와 스니펫은
plantillas/에 있으며 필요할 때 읽습니다.plantillas/,references/,Designs/,Components/경로는 이 파일이 있는 폴더를 기준으로 합니다.
이 스킬이 달성하는 것
평범한 랜딩 페이지를 웹 경험으로 전환합니다: 스크롤과 포인터가 지속적인 애니메이션의 컨트롤러가 됩니다. 브랜드에 구애받지 않으며 각 프로젝트의 색상/토큰을 전달받습니다.
7가지 효과 (카탈로그)
- 부드러운 스크롤 (기초): Lenis. 모든 것이 프리미엄처럼 느껴지게 하는 기반입니다.
- 레이어 패럴랙스: 느린 배경 / 빠른 전경 = 깊이감.
- 스크롤 연동 애니메이션: 스크롤百分比에 연결된 속성.
- 스크롤 리빌: 뷰포트에 나타날 때 등장/애니메이션.
- 스티키 / 핀: 어떤 요소가 '고정'되는 동안 주변 요소가 변경됩니다 (스태킹 카드).
- 포인터 마이크로 인터랙션: 3D 틸트, 커스텀 커서, 호버.
- 스프링 기반 제스처: 드래그, 드롭, 탭: 고정된 지속 시간의 CSS 전환 대신 인터럽트 가능한 스프링 물리학을 사용합니다. 아래 별도 섹션 참조.
제스처 및 스프링 (Emil Kowalski의 apple-design 스킬, WWDC에서 추출, 통합됨)
위의 스크롤/패럴랙스와는 다른 영역입니다: 무언가(메뉴, 슬라이드 가능한 카드, 모달, 슬라이더)를 터치하고 드래그하는 물리학입니다. 웹에 가장 적용 가능한 원칙들 (원본 17개 중; 요약은 references/recetas-y-matriz.md §4bis에 있습니다):
- 인터럽트 가능성, 17개 중 가장 중요함: 모든 애니메이션은 중간에 잡혀서 방향을 바꿀 수 있어야 합니다. 사용자가 터치할 수 있는 모든 것에는 스프링 (매개변수:
damping+response/속도)을 사용하고, 절대 고정 지속 시간의 CSStransition을 사용하지 마십시오: 스프링은 항상 현재 위치에서 애니메이션을 시작하는 방법을 알지만, 고정 전환은 그렇지 않습니다. - 속도 전달: 제스처를 놓으면 애니메이션이 손가락의 속도로 계속 진행됩니다 (0에서 시작하지 않음). 따라서 시각적 '이음새'가 없습니다. 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 | 동일한 디자인의 1/4 이동 거리: 움직임이 카메라처럼 보이지 않고 악센트처럼 읽힙니다. |
URL ?motion=off | 0 | 스스로 움직이던 모든 것이 멈추고 motion 클래스가 제거됩니다. 방문자가 손가락으로 드래그하는 것은 계속 반응합니다: 밀 수 없는 슬라이드 카드는 절제된 인터페이스가 아니라 고장난 사진입니다. 움직임을 원하지 않는 사람을 위한 안전 밸브이며 디자인 모드가 아닙니다. |
URL ?motion=full | 강제 1 | 시스템 환경 설정을 무시합니다. Windows 애니메이션 효과가 비활성화된 장비에서 작업을 검토하기 위한 용도입니다. |
0.25는 하우스 값이며, 효과가 요구하는 경우 프로젝트별로 조정 가능하지만, 절대 1이어서는 안 됩니다: reduce 상태에서 아무것도 변하지 않는다면 정책을 적용하지 않는 것입니다.
다이얼의 세 가지 규칙
gain은 이동 거리를 곱합니다: 픽셀, 크기, 회전, 왜곡. 연속 효과(마키, 루프)에서는 속도를 곱합니다.gain은 절대 불투명도를 곱하지 않습니다. 페이드는 누구도 어지럽히지 않습니다. 따라서 다이얼을 낮출 때 효과가 깨지지 않습니다: 저하됩니다.gain: 0.25를 가진 마트료시카는 동일한 내용을 말하지만, 카메라 줌 대신 체인 페이드 형태로 말합니다. 그리고 이것이 이 정책이 각 효과에 대한 두 번째 버전을 작성하도록 강제하지 않는 이유이며, 이것이 바로 원칙 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아래에서는 큰 움직임을 ~0으로 줄이거나 페이드로 대체해야 하며, "더 작지만 존재하는" 상태로 두어서는 안 됩니다. 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.7fps, 2.4초 정지 | 27.5fps, 0.13초 | 42.6fps, 47ms |
| 포트폴리오 (Lenis, 블러 오브, 3D) | 4.6fps, 372ms | 24.8fps, 84ms | 45.3fps, 49ms |
| 제품 (Lenis 없음; 블러 구름, 오버레이 그레인, 유리 데모) | 30.1fps, 260ms | 42.6fps, 74ms | 46.5fps, 46ms |
그래픽 카드가 있는 경우 라이트 모드는 켜지지 않으며 아무것도 변경되지 않습니다 (세 사이트 모두 픽셀 단위로 확인됨).
이유. 그래픽 카드가 없으면 프로세서가 그래픽 카드가 하던 일(흐림, 혼합, 3D 및 각 프레임 구성)을 수행합니다. 그리고 Lenis를 사용하면 스크롤이 매 프레임마다 우리의 코드에 의해 움직입니다: 메인 스레드가 초당 5프레임이면 페이지는 5fps로 움직입니다. 브라우저의 스크롤은 다른 스레드에 의해 움직이며 메인 스레드가 바빠도 계속 부드럽습니다 (그래서 cloudflare.com이 잘 작동합니다: 코드는 2fps로 가고 화면은 86fps로 갑니다).
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> 내에서는 외부 주소도 확인합니다. jsdom 및 프리렌더에서는 그래픽 카드가 있다고 가정합니다.
2. 해당 경우에만:
- (a) Lenis를 시작하지 않음: 브라우저 스크롤을 사용하고, 대신 동일한 모양을 가진 네이티브 조각을 사용합니다 (
smooth옵션의scrollTo, 메뉴의 경우<html>에overflow: hidden을 사용한stop/start,on("scroll"),animatedScroll). 이 작업은plantillas/react/useLenis.ts(및 vanilla의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(overlay의 그레인)는 더 낮은 불투명도를 가진 일반 혼합으로 전환됩니다. 거의 동일하게 보이고 동일하게 움직입니다. - (c) 3D: 웹의 각
getContextWebGL은failIfMajorPerformanceCaveat: true로 요청되므로, 3D 없는 버전으로 자동 대체됩니다. 이 3D 없는 버전은 존재해야 합니다 (이미지, 평면 로고, 또는 장식용 배경이었다면 아무것도 없음). - (d) 애니메이션은 제외. 하우스 정책은 변경되지 않습니다: 모든 사람을 위한 애니메이션, 진폭이 조정될 뿐 꺼지지 않습니다. 그리고 측정되었습니다: 표의 SaaS에서 애니메이션 배경을 제거하거나 CSS 애니메이션을 일시 중지해도 아무 변화가 없었습니다 (28에서 29-30fps). 제품의 경우 점과 빛 기둥도 마찬가지였습니다. 무거운 것은 (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 4 (일반 노트북). 화면이 없는 Chrome (Lighthouse의 Chrome)은 그래픽 카드로 렌더링합니다: 이 목적에는 적합하지 않습니다. 원인을 찾기 위해, 주입된 CSS (display: none, filter: none, mix-blend-mode: normal)로 하나씩 제거하고 다시 측정합니다: 이렇게 표의 제품에서 구름(0.8초에서 0.35초, 첫 번째 프레임까지), 그레인 및 데모가 발견되었고, 표지의 유리와 점은 영향을 미치지 않는다는 것을 알 수 있었습니다.
그래픽 카드가 있는 상태에서의 성능: 애니메이션 스크롤이 있는 모든 웹을 위한 다섯 가지 규칙
두 개의 실제 웹에서 측정됨 (하나는 느린 프레임에서 CPU 4x에서 580ms에서 355ms로 작업 시간 감소). 애니메이션을 제거하거나 늦추지 않습니다: 보이지 않는 작업을 제거합니다.
animationend에서getAnimations()를 사용하지 마십시오: 전체 페이지의 스타일을 다시 계산하도록 강제합니다 (4x에서 약 50ms, 종종 스크롤 도중). 요소의animationstart및animationend를 계산하십시오.transform/opacity만 움직이는 애니메이션은 스크롤할 때 일시 중지하지 마십시오: 컴포지터에서 실행되며 절약되는 것이 없으며, 일시 중지 및 재개는 각 스크롤당 두 번의 큰 재계산입니다.- 스크롤하는 동안 '한가한 시간'에 섹션을 마운트하지 마십시오: Lenis는 프레임 사이에 빈 공간을 남기고
requestIdleCallback이 거기에 딱 맞습니다. 스크롤이 멈출 때까지 기다리십시오. - 변경되지 않는 경우 매 스크롤 프레임마다 스타일을 쓰지 마십시오 (각 카드에
--bn: 0)
...