GODRICH
#css애니메이션#버튼#로딩#전환효과#스크롤#대시보드#실전ui#디자인트렌드

scroll-driven animations 폴백 가이드 — 지원이 갈리는 9장면

scroll-driven animations 는 지원하는 브라우저에서만 타임라인을 켜고, 나머지에는 완성된 끝 모양을 기본값으로 남겨 두면 된다. 스크롤 연동 애니메이션을 읽지 못하는 브라우저에서 화면은 어디에 멈춰야 할까 — 정적 최종 상태·기존 전환 폴백·줄이기 설정과의 겹침을

scroll-driven animations 는 스크롤로 재생되는 기능

zip 구성과 여는 법

이 기능은 애니메이션의 재생 시각을 시계가 아니라 스크롤 위치가 정하게 하는 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 벌어진다.

읽기 진행 표시에 맞고, 타임라인이 있는 브라우저에서까지 이벤트 막대를 그대로 두는 것은 쓰지 않는다.

스크롤 타임라인 — 페이지 진행률로 막대 채우기
전체 코드 새 창에서 열기

01 · 스크롤 타임라인 — 페이지 진행률로 막대 채우기 — 측정 누적면적 35.842% · 움직인 프레임 20/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

SCRIPT_CALLSMAX_GAPLAG_FRAMES
    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 에서 시작했다(실측).

카드와 이미지가 나타나는 연출에 맞는다.

요소 가시 구간 — 화면에 들어오고 나가는 동안만 재생
전체 코드 새 창에서 열기

02 · 요소 가시 구간 — 화면에 들어오고 나가는 동안만 재생 — 측정 누적면적 27.504% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

RANGE_STARTRANGE_ENDviewProg
    // 카드 윗변이 창 아랫변에 닿을 때 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 까지 벌어진다.

지원 여부가 섞인 방문자를 받을 때 맞는다.

지원 감지 — 조건부 규칙과 스크립트 폴백 전환
전체 코드 새 창에서 열기

03 · 지원 감지 — 조건부 규칙과 스크립트 폴백 전환 — 측정 누적면적 37.535% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

SWITCH_TFINAL_CSSFINAL_JS
    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장이 되므로 쓰지 않는다.

정적 최종 상태 — 미지원에서는 완성된 모습으로 두기
전체 코드 새 창에서 열기

04 · 정적 최종 상태 — 미지원에서는 완성된 모습으로 두기 — 측정 누적면적 36.261% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

UNSUP_TVIS_UN_GOODVIS_UN_BAD
    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초에 끝난다.

미지원에서도 등장 연출을 남기고 싶을 때 맞고, 위아래로 스크롤하며 진행을 되감아야 하는 막대에는 한 번 재생이라 쓰지 않는다.

기존 전환 폴백 — 화면에 들어올 때 한 번 재생
전체 코드 새 창에서 열기

05 · 기존 전환 폴백 — 화면에 들어올 때 한 번 재생 — 측정 누적면적 35.815% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

THRESHOLDTRANS_StTrig
    // 카드가 창에 보이는 비율 — 창 아랫변 위로 올라온 높이 ÷ 카드 높이
    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% 미만이었다.

스크롤 연동을 스크립트로 이미 쓰고 있다면 성능만 이유로 갈아엎을 근거는 약하다.

프레임 비교 — 스크롤 이벤트 방식과 타임라인 방식
전체 코드 새 창에서 열기

06 · 프레임 비교 — 스크롤 이벤트 방식과 타임라인 방식 — 측정 누적면적 35.146% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

NODESmsAivB
    // 타임라인판 방식 — 위치만 쓴다. 읽을 값도, 막대에 쓸 값도 스크립트에 없다
    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개로 같았다.

스크롤 연동과 접근성 설정을 함께 지켜야 하는 화면에 맞는다.

줄이기 설정 겹침 — 타임라인과 동작 줄임이 함께 켜질 때
전체 코드 새 창에서 열기

07 · 줄이기 설정 겹침 — 타임라인과 동작 줄임이 함께 켜질 때 — 측정 누적면적 22.837% · 움직인 프레임 10/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

EDGE_ATDISTFN7
    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 벌어진다.

미지원에서 같은 진행 값을 만들 때 쓰고 문서 높이로만 나누는 식은 쓰지 않으며, 비교표는 함정 절에 있다.

스크롤 값 계산 — 읽기 전용으로 진행률 구하기
전체 코드 새 창에서 열기

08 · 스크롤 값 계산 — 읽기 전용으로 진행률 구하기 — 측정 누적면적 35.529% · 움직인 프레임 19/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

MAX_SCROLLMAX_GAP_NAIVEMEAN_GAP_OK
    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개이고 같게 보이는 쌍이 하나 생긴다.

배포 전에 브라우저별 확인 순서를 정할 때 쓰며, 일부 지원과 스크립트 꺼짐은 실제 브라우저가 아니라 흉내 낸 환경이다.

브라우저 시나리오 — 지원·부분 지원·미지원 세 환경
전체 코드 새 창에서 열기

09 · 브라우저 시나리오 — 지원·부분 지원·미지원 세 환경 — 측정 누적면적 33.069% · 움직인 프레임 20/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

SCENARIO_COUNTsignaturedistinctCells
    // 환경 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 항목이다.

압축 비밀번호를 입력하세요

비밀번호는 이 글 본문 안에 있습니다. 읽다 보면 나옵니다.