diff --git a/apps/site/src/components/Pipeline.astro b/apps/site/src/components/Pipeline.astro index 4c68ea3..c2b0d72 100644 --- a/apps/site/src/components/Pipeline.astro +++ b/apps/site/src/components/Pipeline.astro @@ -225,11 +225,10 @@ const { c } = Astro.props; overflow-wrap: anywhere; } - /* sticky 게이트가 끝까지 돌려면 스파인 뒤에 스크롤 구간이 필요하다. - 한동안 여기에 마무리 문장을 한 줄 놓아 그 자리를 채웠는데, - 읽는 사람에게는 뜬금없는 문장이었다 — 여백이 필요하면 여백을 만든다. - 문장으로 여백을 대신하지 않는다. */ - .spine { padding-bottom: 62dvh; } + /* 한때 여기에 padding-bottom: 62dvh 가 있었다. 게이트 진행도를 섹션 높이로 + 재고 있어서, 여섯 단계를 다 돌리려면 목록 뒤에 화면 절반이 넘는 빈 공간이 + 필요했다. 콘텐츠가 아니라 스크롤 연료였다. + 진행도를 목록이 화면을 지나는 구간으로 바꾸면서 그 여백이 필요 없어졌다. */ @media (max-width: 780px) { .stop { @@ -252,16 +251,19 @@ const { c } = Astro.props; const canvas = document.getElementById("pipeline-canvas") as HTMLCanvasElement | null; const section = document.getElementById("pipeline"); + const spine = document.querySelector("#pipeline .spine"); const stops = [...document.querySelectorAll("#pipeline .stop")]; - if (canvas && section && stops.length) { + if (canvas && section && spine && stops.length) { let last = -1; mountGateScene({ canvas, accentVar: "--accent", glowVar: "--glow-2", - // 캔버스는 sticky 라 rect 가 변하지 않는다. 진행도는 섹션에서 읽는다. - progressFrom: section, + // 캔버스는 sticky 라 rect 가 변하지 않는다. + // 진행도는 섹션이 아니라 **정거장 목록**에서 읽는다 — 게이트가 도는 구간과 + // 읽는 구간이 같아야 목록 뒤에 스크롤용 빈 공간을 두지 않아도 된다. + progressFrom: spine, onGate(index) { if (index === last) return; last = index; diff --git a/apps/site/src/lib/gate-scene.ts b/apps/site/src/lib/gate-scene.ts index f5bc865..9b53040 100644 --- a/apps/site/src/lib/gate-scene.ts +++ b/apps/site/src/lib/gate-scene.ts @@ -319,14 +319,20 @@ async function boot({ canvas, accentVar, glowVar, onGate, progressFrom }: GateSc // rect 는 프레임당 한 번만 읽는다. 두 번 읽으면 레이아웃을 두 번 강제한다. const rect = (progressFrom ?? canvas).getBoundingClientRect(); // 진행 거리. - // progressFrom 이 있으면 캔버스는 sticky 로 화면에 붙어 있고 섹션이 지나간다. - // 이때 캔버스가 실제로 화면에 머무는 거리는 (섹션 높이 - 뷰포트 높이)다. - // 섹션 높이를 그대로 쓰면 캔버스가 사라진 뒤에도 진행이 남아 마지막 게이트에 - // 영영 도달하지 못한다 — 실측에서 6단계 중 3단계에서 멈췄다. + // 한때 (섹션 높이 - 뷰포트)로 쟀다. 그러면 진행 구간이 섹션 길이에 묶여서, + // 게이트를 다 돌리려면 목록 뒤에 62dvh 짜리 빈 공간을 둬야 했다. + // 화면 절반이 넘는 여백이 생기고, 그건 콘텐츠가 아니라 스크롤 연료였다. + // + // 대신 **읽는 대상이 화면을 지나는 동안**으로 맞춘다. + // 위 70% 지점에 닿으면 0, 아래 30% 지점을 빠져나가면 1. + // 목록이 눈앞에 있는 동안만 게이트가 돌아서 빈 공간이 필요 없다. + const start = innerHeight * 0.7; + const end = innerHeight * 0.3; const travel = progressFrom - ? Math.max(rect.height - innerHeight, 1) + ? rect.height + (start - end) : rect.height * 0.92; - const progress = Math.min(Math.max(-rect.top / travel, 0), 1); + const offset = progressFrom ? start - rect.top : -rect.top; + const progress = Math.min(Math.max(offset / travel, 0), 1); bgUniforms.uProgress.value = progress; bgUniforms.uTime.value = t; diff --git a/packages/skill/references/motion.md b/packages/skill/references/motion.md index d1427f6..c04a03a 100644 --- a/packages/skill/references/motion.md +++ b/packages/skill/references/motion.md @@ -654,12 +654,37 @@ sticky 캔버스의 진행도는 `섹션 높이 − 뷰포트` 다. 그래서 " .after { padding-bottom: 62dvh; } /* 스크롤 구간 — 계산으로 정한다 */ ``` -여백을 **마지막 항목 뒤**에 몰면, 목록은 촘촘하게 읽히고 스크롤 구간은 확보된다. -목록이 끝난 뒤의 공백은 빈칸이 아니라 여운으로 읽힌다 — 스크롤텔링의 기본 문법이다. - 판정 기준: **게이트 하나당 200px 이상**. 휠 한 번이 100~150px 이므로 그 아래면 "조금만 스크롤해도 다 지나가는" 과민한 반응이 된다. +### 스크롤 구간이 모자라면 여백이 아니라 **진행도 공식**을 고쳐라 + +위 문제를 처음에는 목록 뒤에 여백을 넣어 풀었다. `padding-bottom: 62dvh`. +계산은 맞았고 게이트는 끝까지 돌았는데, 화면 절반이 넘는 빈 공간이 남았다. +사용자가 본 것은 그 빈칸이었다 — "어마어마하게 큰 이상한 게 있는데요?" + +**그 여백은 콘텐츠가 아니라 스크롤 연료였다.** 원인은 진행도를 섹션 높이로 +잰 것이다. 그러면 진행 구간이 섹션 길이에 묶이고, 구간을 늘리는 유일한 방법이 +섹션을 늘리는 것뿐이다. + +진행도를 **읽는 대상이 화면을 지나는 동안**으로 바꾸면 여백이 필요 없어진다. + +```js +// 섹션이 아니라 목록에서 읽는다. 게이트가 도는 구간과 읽는 구간이 같아진다. +const rect = list.getBoundingClientRect(); +const start = innerHeight * 0.7; // 목록 위쪽이 여기 오면 진행 0 +const end = innerHeight * 0.3; // 목록 아래쪽이 여기를 빠져나가면 진행 1 +const travel = rect.height + (start - end); +const progress = clamp01((start - rect.top) / travel); +``` + +`(start - end)` 만큼이 공짜로 얻는 구간이다. 뷰포트의 40% 를 쓰면 +목록 963px 짜리가 1323px 구간이 되고, 게이트 6 개면 하나당 220px 이다. +**여백 558px 을 지우고도 기준을 넘겼다.** + +> 확인할 것: sticky 요소가 `progress === 1` 에 닿기 전에 사라지지 않아야 한다. +> 목록 아래쪽이 화면 30% 에 있을 때 섹션 하단이 아직 뷰포트 안이면 안전하다. + --- ## 4. JS 스택 판단 — 언제 끌어오고 언제 안 끌어오나