scroll-driven animations 폴백 가이드 — 지원이 갈리는 9장면
scroll-driven animations 는 지원하는 브라우저에서만 타임라인을 켜고, 나머지에는 완성된 끝 모양을 기본값으로 남겨 두면 된다. 스크롤 연동 애니메이션을 읽지 못하는 브라우저에서 화면은 어디에 멈춰야 할까 — 정적 최종 상태·기존 전환 폴백·줄이기 설정과의 겹침을
scroll-driven animations 는 스크롤로 재생되는 기능
01 sd-scroll-timeline
02 sd-view-range
03 sd-detect-switch
04 sd-static-end
05 sd-transition-fallback
06 sd-frame-cost
07 sd-reduce-overlap
08 sd-scroll-calc
09 sd-browser-matrix
- 01 스크롤 타임라인 — 페이지 진행률로 막대 채우기
- 02 요소 가시 구간 — 화면에 들어오고 나가는 동안만 재생
- 03 지원 감지 — 조건부 규칙과 스크립트 폴백 전환
- 04 정적 최종 상태 — 미지원에서는 완성된 모습으로 두기
- 05 기존 전환 폴백 — 화면에 들어올 때 한 번 재생
- 06 프레임 비교 — 스크롤 이벤트 방식과 타임라인 방식
- 07 줄이기 설정 겹침 — 타임라인과 동작 줄임이 함께 켜질 때
- 08 스크롤 값 계산 — 읽기 전용으로 진행률 구하기
- 09 브라우저 시나리오 — 지원·부분 지원·미지원 세 환경
이 기능은 애니메이션의 재생 시각을 시계가 아니라 스크롤 위치가 정하게 하는 CSS 기능이다. 스크롤을 절반 내리면 막대가 절반 차고, 올리면 같은 속도로 줄어든다.
타임라인은 두 종류다. animation-timeline scroll() 은 스크롤 상자 전체의 진행을 0에서 100% 로 읽고, view() 는 요소가 화면을 지나가는 동안의 진행만 읽는다.
이 글은 두 타임라인이 없는 브라우저에서 같은 화면이 어디에 멈춰야 하는지를 아홉 장면으로 비교한다. 쓸 코드는 라이브러리 없이 CSS 몇 줄과 읽기 전용 스크립트가 전부다.
데모는 캔버스에 그린 계산 모델이다
아홉 데모는 CSS 타임라인을 직접 쓰지 않고 캔버스에 계산으로 그린 모델이다. 데모를 찍는 렌더 도구가 CSS 애니메이션을 정지시키기 때문에 데모 안에 animation-timeline 규칙을 둘 수 없었다.
그래서 데모 안의 문서는 가상이다. 높이 DOC_H 300, 보이는 창 VIEW_H 100, 이동 가능한 거리 MAX_SCROLL 200 이고, 스크롤은 4.6초짜리 시간표 scrollAt 가 정한다.
진짜 CSS 타임라인과 관찰자는 Playwright 로 연 Chrome 에서 따로 잰 값이고, 글에서 「실측」 이라고 부르는 숫자가 그것이다. 미지원 칸은 실제 브라우저가 아니라 지원 감지를 거짓으로 돌린 흉내 환경이다.
스크롤 연동 폴백 9종 — 감지부터 시나리오까지
표의 면적·프레임·강도는 도구/demo.py 가 Chrome 으로 480×300 캔버스를 2초 동안 24장 찍고, 이어지는 두 장의 차 23개를 비교해 얻었다. 렌더에 쓴 Chrome 의 세부 버전은 기록이 없어 미확인이다.
누적면적은 24장 중 한 번이라도 첫 장과 달라진 픽셀이 화면에서 차지한 비율이고, 강도는 그 픽셀의 색 차이 평균(0~255)이다. 움직인 프레임은 직전 장과 비교해 달라진 장의 수다.
이 값은 캔버스 안 그림의 변화이지 실제 CSS 타임라인의 성능이 아니다. 06 의 데모 안 시간 표본도 포스터 렌더 1회 값이라 반올림 영향이 커서 비율로 읽지 않고, 비교는 Playwright 실측으로만 한다.
| 장면 | 누적면적 | 움직인 프레임 | 강도 평균 |
|---|---|---|---|
| 01 스크롤 타임라인 | 35.8% | 20/23 | 46.0 |
| 02 요소 가시 구간 | 27.5% | 19/23 | 46.9 |
| 03 지원 감지 | 37.5% | 19/23 | 37.0 |
| 04 정적 최종 상태 | 36.3% | 19/23 | 71.1 |
| 05 전환 폴백 | 35.8% | 19/23 | 47.4 |
| 06 프레임 비교 | 35.1% | 23/23 | 47.7 |
| 07 줄이기 겹침 | 22.8% | 10/23 | 78.1 |
| 08 스크롤 값 계산 | 35.5% | 19/23 | 46.8 |
| 09 브라우저 시나리오 | 33.1% | 20/23 | 46.5 |
누적면적이 가장 넓은 것은 03 이고 가장 좁은 것은 07 이다. 움직인 프레임은 06 만 23/23 이고, 07 은 줄이기 설정이 켜진 칸이 멈춰 10/23 으로 가장 적다.
장면은 세 묶음이다. 01·02 는 타임라인 자체, 03~06 은 미지원에서 화면을 지키는 방식, 07~09 는 설정과 환경이 겹칠 때의 판단이다.
01스크롤 타임라인 — 페이지 진행률로 막대 채우기
progAt 가 스크롤 위치를 MAX_SCROLL 으로 나눈 진행률로 바꾸고, 스크립트판은 스크롤 이벤트에서 읽은 늦은 위치 scrollLag 를 써서 LAG_FRAMES 1 만큼 한 프레임 늦는다. 한 번 내려가는 동안 스크립트판은 막대를 SCRIPT_CALLS 108번 고치고 두 막대는 최대 1.6%p 벌어진다.
읽기 진행 표시에 맞고, 타임라인이 있는 브라우저에서까지 이벤트 막대를 그대로 두는 것은 쓰지 않는다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="스크롤 진행률로 채우는 막대를 타임라인판과 스크립트 폴백판으로 나란히 놓고 값의 어긋남을 재는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 604줄 — 아래 「전체 코드」에서 원문 전체)// ScrollTimeline - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ScrollTimeline.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 569줄 — 아래 「전체 코드」에서 원문 전체)01 · 스크롤 타임라인 — 페이지 진행률로 막대 채우기 — 측정 누적면적 35.842% · 움직인 프레임 20/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
function scrollAt(t) {
if (t < UP_TO + 0.2) {
return MAX_SCROLL * EASE_IN_OUT(clamp((t - UP_FROM) / (UP_TO - UP_FROM), 0, 1));
}
return MAX_SCROLL * (1 - EASE_IN_OUT(clamp((t - DOWN_FROM) / (DOWN_TO - DOWN_FROM), 0, 1)));
}
// 스크롤 진행률 0 에서 1 — 타임라인이 쓰는 값. 스크롤 위치 ÷ (문서 높이 − 창 높이)
function progAt(s) { return clamp(s / MAX_SCROLL, 0, 1); }
// 스크립트가 스크롤 이벤트에서 읽어 막대에 쓴 값은 몇 프레임 전 위치다 (LAG_FRAMES = 1)
const LAG_FRAMES = 1;
function scrollLag(t) { return scrollAt(Math.max(0, t - LAG_FRAMES / FPS)); }
02요소 가시 구간 — 화면에 들어오고 나가는 동안만 재생
viewProg 가 카드 윗변이 창 아랫변에 닿을 때 0, 아랫변이 창 윗변을 벗어날 때 1 로 진행을 계산하고, rangeVal 이 그 값을 구간 RANGE_START~RANGE_END 안으로 다시 편다. 구간을 0~50% 로 두면 변화가 끝나는 스크롤이 68px 이고, 실제 animation-range: cover 0% 50% 도 같은 68px 에서 끝나며 첫 변화는 1px 에서 시작했다(실측).
카드와 이미지가 나타나는 연출에 맞는다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기, 왼쪽·오른쪽 방향키로 구간의 시작점을 바꾼다">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="카드가 창을 지나는 동안 가시 구간의 일부에서만 변하는 모양과 진행률별 불투명도 곡선을 함께 보는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 605줄 — 아래 「전체 코드」에서 원문 전체)// ViewRange - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ViewRange.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 566줄 — 아래 「전체 코드」에서 원문 전체)02 · 요소 가시 구간 — 화면에 들어오고 나가는 동안만 재생 — 측정 누적면적 27.504% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
// 카드 윗변이 창 아랫변에 닿을 때 0, 카드 아랫변이 창 윗변을 벗어날 때 1
function viewProg(s) { return clamp((s + VIEW_H - CARD_Y) / (VIEW_H + CARD_H), 0, 1); }
function rangeVal(v, rs, re) { return clamp((v * 100 - rs) / (re - rs), 0, 1); }
// 구간이 시작하고 끝나는 스크롤 위치(px)
function scrollAtPct(pct) { return CARD_Y - VIEW_H + (pct / 100) * (VIEW_H + CARD_H); }
function curRange(v) { return rangeVal(v, RANGE_START, RANGE_END); }
03지원 감지 — 조건부 규칙과 스크립트 폴백 전환
감지가 참이면 CSS 판만, 거짓이면 스크립트 판만 막대를 채우도록 SWITCH_T 1.2초에 unsupportedAt 이 뒤집힌다. 두 판의 최종 너비는 FINAL_CSS·FINAL_JS 모두 204px 로 같고, 이동 중에는 GAP_PX 가 최대 3.3px 까지 벌어진다.
지원 여부가 섞인 방문자를 받을 때 맞는다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="지원 감지 결과에 따라 CSS 판과 스크립트 판 가운데 하나만 막대를 채우는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 595줄 — 아래 「전체 코드」에서 원문 전체)// DetectSwitch - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DetectSwitch.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 560줄 — 아래 「전체 코드」에서 원문 전체)03 · 지원 감지 — 조건부 규칙과 스크립트 폴백 전환 — 측정 누적면적 37.535% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
const SWITCH_T = 1.2;
function unsupportedAt(t) { return simOn || t >= SWITCH_T; }
// 두 판의 최종 너비(px)와 이동 중 가장 큰 차이(px)
const FINAL_CSS = VW * progAt(scrollAt(UP_TO));
const FINAL_JS = VW * progAt(scrollLag(UP_TO + 0.2));
const GAP_PX = (MAX_GAP_PCT() / 100) * VW;
04정적 최종 상태 — 미지원에서는 완성된 모습으로 두기
opOf 는 미지원에서 좋은 판에 1, 나쁜 판에 0 을 돌려주므로 UNSUP_T 0.7초 뒤 보이는 카드는 3장 대 0장이다. 지원 환경의 스크롤 끝에서는 두 판 모두 3장이라 차이는 미지원에서만 드러난다.
새 기능을 점진적으로 얹을 때 맞고, 시작 모양인 투명 상태를 기본값으로 두는 방식은 미지원 방문자에게 내용이 0장이 되므로 쓰지 않는다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="기본값이 끝 모양인 판과 시작 모양인 판을 미지원 환경에서 보이는 카드 수로 비교하는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 617줄 — 아래 「전체 코드」에서 원문 전체)// StaticEnd - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./StaticEnd.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 578줄 — 아래 「전체 코드」에서 원문 전체)04 · 정적 최종 상태 — 미지원에서는 완성된 모습으로 두기 — 측정 누적면적 36.261% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
function unsupportedAt(t) { return simOn || t >= UNSUP_T; }
function vOf(i, s) { return clamp((s + VIEW_H - CARDS_Y[i]) / (VIEW_H + CH4), 0, 1); }
// 카드 i 의 불투명도 — 지원이면 구간 값, 미지원이면 기본값(좋은 판은 1, 나쁜 판은 0)
function opOf(i, s, un, good) {
if (un) {
return good ? 1 : 0;
}
return clamp(vOf(i, s) * 100 / RANGE4_END, 0, 1);
}
05기존 전환 폴백 — 화면에 들어올 때 한 번 재생
visFrac 이 보이는 비율을 재고 THRESHOLD 0.2 에 닿는 시각 trigAt 에 한 번 흐르는 전환이 시작되며, 그 스크롤은 12px 이고 실제 IntersectionObserver 의 첫 알림도 12px 이었다(실측). 타임라인판은 스크롤을 따라 767ms 동안 이어서 변하고 폴백은 TRANS_S 0.5초에 끝난다.
미지원에서도 등장 연출을 남기고 싶을 때 맞고, 위아래로 스크롤하며 진행을 되감아야 하는 막대에는 한 번 재생이라 쓰지 않는다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기, 왼쪽·오른쪽 방향키로 관찰 문턱을 바꾼다">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="스크롤에 묶여 오르내리는 타임라인판과 보이는 비율이 문턱에 닿을 때 한 번만 재생하는 관찰자판을 나란히 놓는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 632줄 — 아래 「전체 코드」에서 원문 전체)// TransitionFallback - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./TransitionFallback.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 585줄 — 아래 「전체 코드」에서 원문 전체)05 · 기존 전환 폴백 — 화면에 들어올 때 한 번 재생 — 측정 누적면적 35.815% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
// 카드가 창에 보이는 비율 — 창 아랫변 위로 올라온 높이 ÷ 카드 높이
function visFrac(s) { return clamp((VIEW_H - (CARD_Y - s)) / CARD5_H, 0, 1); }
function viewV(s) { return clamp((s + VIEW_H - CARD_Y) / (VIEW_H + CARD5_H), 0, 1); }
function tlVal(s) { return clamp(viewV(s) * 100 / RANGE5_END, 0, 1); }
// 관찰자가 처음 알리는 시각 — 보이는 비율이 THRESHOLD 이상이 되는 첫 시각
function trigAt() {
for (let t = 0; t <= LAP_S; t += 1 / 240) {
if (visFrac(scrollAt(t)) >= THRESHOLD) {
return t;
}
}
return LAP_S;
}
06프레임 비교 — 스크롤 이벤트 방식과 타임라인 방식
handler 는 스크롤 이벤트마다 scrollTop 을 읽고 진행률을 계산해 막대 너비를 쓰고 요소 위치를 한 번 더 읽으며, bareScroll 은 위치만 줄 뿐 읽거나 쓰는 일이 없다.
진짜 Chrome 3세션에서 프레임 간격 평균은 두 방식 모두 16.667ms 로 상대 차가 0% 였고, 핸들러 시간은 이 렌더 환경의 노드 300개에서 0.226~0.238ms, 1,200개에서 0.202~0.216ms 라 프레임 예산의 1.5% 미만이었다.
스크롤 연동을 스크립트로 이미 쓰고 있다면 성능만 이유로 갈아엎을 근거는 약하다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기, 왼쪽·오른쪽 방향키로 문서 노드 수를 바꾼다">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="같은 스크롤을 타임라인판 방식과 스크립트판 방식으로 번갈아 처리하며 스크립트 시간과 프레임 간격을 재는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 703줄 — 아래 「전체 코드」에서 원문 전체)// FrameCost - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./FrameCost.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 641줄 — 아래 「전체 코드」에서 원문 전체)06 · 프레임 비교 — 스크롤 이벤트 방식과 타임라인 방식 — 측정 누적면적 35.146% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
// 타임라인판 방식 — 위치만 쓴다. 읽을 값도, 막대에 쓸 값도 스크립트에 없다
function bareScroll(s) { rig.scrollTop = s; }
// 스크립트판 방식 — 스크롤 이벤트 핸들러가 하는 일: 위치를 읽고, 진행률을 계산하고, 막대 너비를 쓰고, 요소 위치를 한 번 더 읽는다
function handler(s) {
rig.scrollTop = s;
const p = rig.scrollTop / (rig.scrollHeight - rig.clientHeight);
rigBar.style.width = (p * VW) + 'px';
const last = rigDoc.lastElementChild;
if (last) {
void last.getBoundingClientRect().top;
}
}
07줄이기 설정 겹침 — 타임라인과 동작 줄임이 함께 켜질 때
FN7 의 네 함수가 한 번 스크롤하는 동안 만드는 서로 다른 불투명도 값은 지원·꺼짐에서 21개, 미지원·꺼짐에서 EDGE_AT 0.25 경계의 2개, 줄이기가 켜지면 지원 여부와 상관없이 1개다. 실제 타임라인도 줄이기 꺼짐에서 21개, animation: none 일 때 1개로 같았다.
스크롤 연동과 접근성 설정을 함께 지켜야 하는 화면에 맞는다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="타임라인 지원 여부와 동작 줄임 설정의 네 조합에서 카드 불투명도가 어떻게 변하는지 곡선으로 비교하는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 614줄 — 아래 「전체 코드」에서 원문 전체)// ReduceOverlap - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ReduceOverlap.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 576줄 — 아래 「전체 코드」에서 원문 전체)07 · 줄이기 설정 겹침 — 타임라인과 동작 줄임이 함께 켜질 때 — 측정 누적면적 22.837% · 움직인 프레임 10/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
const EDGE_AT = 0.25;
function viewV(s) { return clamp((s + VIEW_H - CARD_Y) / (VIEW_H + CARD7_H), 0, 1); }
const FN7 = [
function (p) { return clamp(p * 100 / RANGE7_END, 0, 1); },
function (p) { void p; return 1; },
function (p) { return p >= EDGE_AT ? 1 : 0; },
function (p) { void p; return 1; }
];
08스크롤 값 계산 — 읽기 전용으로 진행률 구하기
위치를 이동 가능한 거리로 나누는 okProg 는 진짜 타임라인 막대와 최대 0.007%p 어긋나 사실상 같고, 문서 높이로만 나누는 naiveProg 는 최대 33.3%p 어긋난다. 한 프레임 늦은 위치를 읽으면 맞는 식도 최대 1.8%p 벌어진다.
미지원에서 같은 진행 값을 만들 때 쓰고 문서 높이로만 나누는 식은 쓰지 않으며, 비교표는 함정 절에 있다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="스크롤 위치를 읽기만 해서 계산한 진행률과 타임라인 값의 어긋남을 맞는 식과 틀린 식으로 재는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 610줄 — 아래 「전체 코드」에서 원문 전체)// ScrollCalc - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ScrollCalc.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 577줄 — 아래 「전체 코드」에서 원문 전체)08 · 스크롤 값 계산 — 읽기 전용으로 진행률 구하기 — 측정 누적면적 35.529% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
const GAP_OK = gapStats(okProg, true);
const GAP_NAIVE = gapStats(naiveProg, true);
const MAX_GAP_OK = GAP_OK[0];
const MAX_GAP_NAIVE = GAP_NAIVE[0];
const MEAN_GAP_OK = GAP_OK[1];
const MEAN_GAP_NAIVE = GAP_NAIVE[1];
// 구간 눈금 — 스크롤 진행률 25%마다 타임라인 값과 틀린 식의 차이
function segGap(pct) { return Math.abs(pct / 100 - naiveProg(MAX_SCROLL * pct / 100)) * 100; }
09브라우저 시나리오 — 지원·부분 지원·미지원 세 환경
지원·타임라인 없음(흉내)·줄이기 켜짐 세 칸은 signature 가 11곳의 막대·카드 값을 적은 지문이 모두 달라 distinctCells 가 3/3 을 돌려준다. 칸을 5개로 늘리면 줄이기 켜짐과 스크립트 꺼짐이 둘 다 [1, 1] 을 내서 서로 다른 모양은 4개이고 같게 보이는 쌍이 하나 생긴다.
배포 전에 브라우저별 확인 순서를 정할 때 쓰며, 일부 지원과 스크립트 꺼짐은 실제 브라우저가 아니라 흉내 낸 환경이다.

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="시연 무대 — Space 또는 Enter 로 일시정지, R 로 처음부터, U 로 미지원 흉내 켜기, 왼쪽·오른쪽 방향키로 비교할 환경 수를 바꾼다">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="같은 페이지를 지원·타임라인 없음·줄이기 켜짐 같은 환경에 나란히 놓고 서로 다르게 보이는 칸을 세는 장면"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">장면 준비</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">일시정지</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">미지원 흉내</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 673줄 — 아래 「전체 코드」에서 원문 전체)// BrowserMatrix - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BrowserMatrix.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 613줄 — 아래 「전체 코드」에서 원문 전체)09 · 브라우저 시나리오 — 지원·부분 지원·미지원 세 환경 — 측정 누적면적 33.069% · 움직인 프레임 20/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
// 환경 e 의 [막대 값, 카드 불투명도] — 0 지원 · 1 타임라인 없음 · 2 줄이기 켜짐 · 3 일부 지원 · 4 스크립트 꺼짐
function envOf(e, s, sl) {
const v = viewV(s);
if (e === 0) {
return simOn ? envOf(1, s, sl) : [progAt(s), clamp(v * 100 / RANGE9_END, 0, 1)];
}
if (e === 1) {
return [progAt(sl), viewV(sl) >= EDGE9 ? 1 : 0];
}
if (e === 2) {
return [1, 1];
}
if (e === 3) {
return [progAt(s), 1];
}
return [1, 1];
}
어떤 폴백을 고를까 — 지원 여부별 선택 기준은?
고르는 순서는 방문자 환경에서 무엇이 모자라는지부터 묻는 것이다. 타임라인이 있으면 CSS 에 맡기고, 없으면 내용이 사라지지 않게 하는 것이 먼저이고, 그다음에 움직임을 얼마나 남길지 정한다.
| 상황 | 고를 방식 | 근거 절 |
|---|---|---|
| 지원 감지가 참 | @supports 안의 타임라인 규칙 |
03 |
| 미지원이고 내용이 사라지면 안 됨 | 끝 모양을 기본값으로 | 04 |
| 미지원이고 등장 연출만 남기고 싶음 | 관찰자로 한 번 재생 | 05 |
| 미지원이고 진행 값이 필요함 | 읽기 전용 계산 | 08 |
| 줄이기 설정이 켜짐 | 즉시 최종 상태 | 07 |
한 방식으로 끝나는 화면은 드물다. 진행 막대는 03 처럼 갈래를 나누고, 카드 등장은 04 의 끝 모양 기본값 위에 05 의 한 번 재생을 얹는다.
구간을 바꿔 가며 쓰는 패턴은 스크롤·뷰 타임라인 구간 패턴에서 효과별로 다뤘고, 관찰자로 트리거 하나를 짜는 방법은 스크롤 트리거 애니메이션 엔진에서 이어진다.
스크롤 진행값이 화면에 닿는 순서 — 동작 흐름
스크롤 위치가 진행률이 된다
타임라인이 하는 일은 스크롤 위치를 0에서 1 로 바꾸는 한 가지다. 이 값을 애니메이션 진행도에 그대로 연결하면 키프레임이 시간이 아니라 위치를 따라 재생된다.
폴백도 같은 값을 만든다
타임라인이 없으면 스크립트가 같은 계산을 대신한다. 아래는 01 의 두 막대가 얼마나 벌어지는지를 재는 설계로, 위치 차를 진행률로 바꿔 최댓값만 남긴다.
function gapMax() {
let m = 0;
for (let t = 0; t <= LAP_S; t += 1 / FPS) {
m = Math.max(m, Math.abs(progAt(scrollAt(t)) - progAt(scrollLag(t))) * 100);
}
return m;
}
const MAX_GAP = gapMax();
위 코드의 progAt(scrollAt(t)) 가 타임라인이 쓰는 값이고 progAt(scrollLag(t)) 가 스크립트가 쓰는 값이다. 이 둘의 차가 MAX_GAP 이라, 폴백의 품질은 읽는 시점이 얼마나 늦느냐로 정해진다.
줄이기 설정이 마지막에 겹친다
값이 만들어진 뒤 사용자가 움직임 줄이기를 켰으면 그 값을 쓰지 않고 끝 모양을 보여 준다. 07 의 네 칸이 바로 이 겹침을 정리한 것이다.
라이브러리 없이 폴백을 붙이는 법
끝 모양을 기본값으로 두고 타임라인은 조건부로 얹는다
데모는 계산으로 두 판을 그리지만 실제 화면에서는 블록 하나다. 기본 규칙에 끝 모양을 쓰고, @supports 안에서만 애니메이션과 타임라인을 선언한다.
.card {
opacity: 1;
}
@supports (animation-timeline: view()) {
.card {
animation: reveal linear both;
animation-timeline: view();
animation-range: cover 0% 50%;
}
}
@keyframes reveal {
from { opacity: 0; }
to { opacity: 1; }
}
위 코드는 독자가 붙여 쓰도록 만든 예시이고 데모 소스는 아니다. 같은 코드를 바로 열어 볼 수 있는 예제 파일 example-scroll-timeline.html 이 zip 에 들어 있다.
animation 단축 속성은 animation-timeline 을 초기값으로 되돌리므로 타임라인 선언은 반드시 단축 속성 뒤에 둔다.
지원이 없을 때 스크립트로 채운다
scroll driven animations polyfill 을 통째로 올리는 대신, 08 의 식 하나로 필요한 값만 만들어 쓰는 방법도 있다.
감지는 CSS.supports('animation-timeline: scroll()') 가 거짓일 때만 스크롤 이벤트를 듣게 하고, 값은 scrollTop ÷ (scrollHeight − clientHeight) 로 읽기만 한다.
등장 연출 정도면 05 처럼 관찰자가 한 번 클래스를 붙이게 하는 편이 단순하다. 연출이 스크롤에 묶여 되감겨야 하는 화면이 아니라면 이쪽을 먼저 고른다.
이징과 같은 규칙으로 정리한다
폴백이 한 번 재생하는 전환이라면 곡선 선택도 따로 필요하다. 곡선을 고르는 기준은 CSS 트랜지션 이징 선택 가이드와 같은 방식으로 정리했다는 점을 참고하면 된다.
스크롤 연동 폴백이 깨지는 함정 — 미지원 화면
문서 높이로 나누면 막대가 끝에 닿지 못한다
08 의 세 식을 진짜 타임라인 막대와 277지점에서 비교한 실측이다. 맞는 식과 틀린 식의 차이는 스크롤이 끝에 가까울수록 커지고, 틀린 식은 스크롤이 끝나도 막대가 2/3 지점에 머문다.
| 식 | 최대 어긋남 | 평균 어긋남 |
|---|---|---|
| 스크롤 위치 ÷ 200(맞는 식) | 0.007%p | 0.003%p |
| 스크롤 위치 ÷ 문서 높이 300(틀린 식) | 33.3%p | 15.9%p |
| 맞는 식 + 한 프레임 늦은 읽기 | 1.8%p | 0.72%p |
| 틀린 식 + 한 프레임 늦은 읽기 | 33.5%p | 15.9%p |
늦은 읽기는 맞는 식을 눈에 띄지 않을 만큼만 흔들고, 식 자체가 틀린 경우는 늦은 읽기와 상관없이 한 구간이 통째로 어긋난다.
이름 있는 타임라인은 공통 조상이 있어야 읽힌다
scroll-timeline: --s 로 이름을 붙인 타임라인을 스크롤 상자 밖의 요소가 읽으려면 둘의 공통 조상이 timeline-scope: --s 를 선언해야 한다. 실측에서 막대의 부모가 따로 같은 이름을 timeline-scope 로 선언하자 막대가 움직이지 않았다.
.page {
timeline-scope: --list;
}
.list {
overflow-y: auto;
scroll-timeline: --list y;
}
.indicator {
animation: fill linear;
animation-timeline: --list;
}
위 코드도 독자용 예시이고, 선언을 두는 곳이 스크롤 상자와 막대를 모두 품는 가장 가까운 조상이라는 점만 확인하면 된다.
값을 쓴 직후에 읽으면 이전 값이 나온다
실측 중 scrollTop 을 바꾼 바로 뒤에 getComputedStyle 로 막대 너비를 읽었더니 바뀌기 전 값이 나왔다. 이 값을 requestAnimationFrame 한 번 뒤에 읽자 새 위치를 따랐다.
타임라인이 계산한 값을 스크립트로 확인하려는 코드가 한 프레임 늦은 값을 보는 이유이고, 폴백 쪽 읽기와 같은 종류의 지연이다.
값을 바꿔 본 차이
세 값을 하나씩 바꿔 본 결과다. 위 함정의 숫자는 이 표에서 되풀이하지 않았다.
| 이름 | 바꾼 값 | 느낌 |
|---|---|---|
| 가시 구간의 시작점을 늦춰 | 02 RANGE_START 0 → 25 | 데모 안 변화가 끝나는 스크롤이 68px 에서 136px 로, 카드가 불투명해지기 시작하는 스크롤이 0px 에서 34px 로 늦어진다. 실제 view() 는 끝이 68px 그대로이고 첫 변화만 1px 에서 35px 로 옮겨 갔다 |
| 관찰 문턱을 높여 | 05 THRESHOLD 0.2 → 0.6 | 재생이 시작되는 스크롤이 12px 에서 36px 로 늦어지고 실제 관찰자 알림도 12px 에서 36px 로 바뀐다 |
| 비교할 환경 수를 늘려 | 09 SCENARIO_COUNT 3 → 5 | 칸이 3개에서 5개로 늘어도 서로 다른 모양은 3개에서 4개로만 늘고 줄이기 켜짐과 스크립트 꺼짐이 같은 쌍이 된다 |
구간은 변화가 끝나는 곳, 문턱은 재생이 시작되는 시점, 환경 수는 점검 범위를 정하므로 하나씩 바꿔 어느 값이 느낌을 바꿨는지 보는 편이 낫다.
아홉 장면의 HTML·CSS·JS 와 react 판, 독자용 예제 파일을 묶은 zip 은 아래 상자에서 받고, 압축을 푸는 암호는 x975kqwb 이다.
브라우저 호환 — Chrome·Safari·Firefox·Edge 지원
데모는 캔버스로 계산해 그리므로 이 표의 지원과 상관없이 돈다. 표는 실제 화면에 옮길 때 어느 버전부터 되는지를 mdn/browser-compat-data 의 JSON 에서 읽은 값이다.
| 기능 | Chrome | Safari | Firefox | Edge |
|---|---|---|---|---|
animation-timeline |
115 | 26 | 159 | Chrome 값을 따름 |
scroll() |
115 | 26 | 159 | Chrome 값을 따름 |
view() |
115 | 26 | 159 | Chrome 값을 따름 |
animation-range |
115 | 26 | 159 | Chrome 값을 따름 |
timeline-scope |
116 | 26 | 159 | Chrome 값을 따름 |
각 칸에는 그 브라우저가 처음 지원한 버전 번호를 적었다. 이 다섯 행에는 version_added 가 비어 있는 칸이 없어 「미지원(버전 없음)」 으로 적을 칸이 생기지 않았다.
각주: Edge 의 「Chrome 값을 따름」 은 browser-compat-data 의 mirror 항목이라, 별도 버전 없이 Chrome 값을 되풀이하라는 표시다.
출처: MDN CSS scroll-driven animations
출처: MDN animation-timeline · MDN @supports
수치 원본은 css/properties/animation-timeline.json 이고, scroll()·view() 행은 이 파일의 하위 항목이다.
animation-range 행은 css/properties/animation-range.json에서 읽었다.
timeline-scope 행은 css/properties/timeline-scope.json에서 읽었다.
어느 행을 보고 쓸까
표에서 가장 늦은 칸은 Firefox 159 라, 그 아래 버전을 쓰는 방문자에게는 타임라인이 없다고 보고 03 의 감지 갈래와 04 의 끝 모양 기본값을 둔다. 이 표는 기능이 처음 들어온 버전만 알려 주므로, 방문자 비율은 따로 로그로 봐야 한다.
스크롤 연동 접근성 — 줄이기 설정과 겹칠 때
아래는 독자가 그대로 붙여 쓸 CSS 이고 데모 소스는 아니다. 타임라인 쪽 규칙을 지우지 않고 줄이기가 켜졌을 때 애니메이션만 끄면, 위의 끝 모양 기본값이 그대로 최종 화면이 된다.
@media (prefers-reduced-motion: reduce) {
.card,
.progress {
animation: none;
}
}
이 블록은 @supports 블록보다 뒤에 두어야 같은 선택자끼리 덮어쓴다.
07 의 결과대로 줄이기가 켜지면 지원 여부와 무관하게 한 가지 모양만 남고, 설정 전반을 장면별로 고르는 기준은 prefers-reduced-motion 적용 가이드에 정리했다.
줄이기가 켜지면 끝 장면 한 장만 그린다
데모 아홉 장면은 시간표만으로 움직이는 자동 시연이라 조작 없이 끝까지 볼 수 있다. 줄이기가 켜져 있으면 루프 없이 시간표 끝 시각 REST_S 2.2초의 한 장만 그리고, 두 장을 캡처해 같은 화면인지 크롬 reduce 에뮬레이션으로 확인했다.
흉내 스위치와 낭독
U 키나 버튼으로 미지원 흉내를 켜고 끌 수 있고, 02 는 ←→ 로 구간 시작점, 05 는 문턱, 06 은 노드 수, 09 는 환경 수를 바꾼다. 상태 줄은 aria-live="off" 라 시연 중에 읽히지 않으며, role="status" 문단이 모드가 바뀔 때만 낭독한다.
일시정지와 숨은 탭
화면의 일시정지 버튼 말고도 Space·Enter·P 로 멈추고 R 로 처음부터 다시 본다. 탭이 숨으면 루프가 멈추고 깜빡임은 초당 3회 이하다.
스크롤 연동 폴백 FAQ — 지원 감지는 어떻게 하나
scroll driven animations safari 에서는 쓸 수 있나요
호환 표의 데이터로는 Safari 26 부터 animation-timeline 을 지원한다. 그보다 낮은 버전은 03 의 감지로 갈라 04 의 끝 모양이나 05 의 한 번 재생을 보이면 된다.
지원 여부는 어떻게 감지하나요
CSS 쪽은 @supports (animation-timeline: scroll()) 블록으로, 스크립트 쪽은 CSS.supports('animation-timeline: scroll()') 로 같은 조건을 묻는다. 두 방법의 갈래를 03 에서 한 화면에 놓고 비교했다.
줄이기 설정이 켜져 있으면 타임라인은 어떻게 하나요
prefers-reduced-motion: reduce 블록에서 animation: none 으로 끄면 끝 모양 기본값이 남는다. 지원 여부와 상관없이 한 가지 모양이 되는 것은 07 에서 확인했다.
출처는 MDN 의 animation-timeline 항목과
@supports 항목이다.









