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

SVG path animation 선 그리기 애니메이션 9종 — 계산부터 스크롤 연동까지

선이 그려진다는 건 점선의 빈칸을 미는 계산이다 — 01번은 원 둘레 길이를 재해 %만큼 채우고, 03번은 getPointAtLength 로 경로 위 이동체 위치를 매 프레임 계산하며, 04번은 스크롤 퍼센트를 dashoffset 산술로 바꾼다.

SVG 선 그리기 애니메이션은 그림이 아니라 stroke-dasharray 로 만든 점선의 빈칸을 stroke-dashoffset 으로 미는 계산이다 — svg path animation 은 어느 만큼의 빈칸을 어느 속도로 당길지 정하는 데서 시작한다

zip 구성과 여는 법

아홉 장면은 같은 무대 위에서 돈다. 안쪽 상자는 480×300 으로 고정되고 화면 폭에 맞춰 통째로 줄어들며, 장면 SVG 는 viewBox 448×156, 그 아래에 차트 상자 448×54 와 읽기줄 두 줄이 붙는다. 시계 역할은 CSS 애니메이션 .clk 하나가 맡아 한 주기가 끝나면 다음 프리셋으로 넘어간다.

바깥 의존은 전혀 없다. 라이브러리·WebGL·CDN·외부 이미지가 0 이고 Math.random·Date·fetch·localStorage 도 없어 재생할 때마다 같은 장면이 나온다 — 06 의 흔들림과 08 의 위상값은 시드 해시 frac(sin(i×12.9898+seed×78.233)×43758.5453) 로 정해진 고정값이다.

프리셋은 장면마다 방향키로 바꾼다. 01 은 목표를 62·38·85% 로, 02 는 STAGGER_MS 를 240·600·120 으로, 04 는 MAP_RANGE 를 1.0·0.5 로, 06 은 DISTURB_PX 를 1.5·4·0.5 로, 08 은 WAVE_PHASE 를 0.9·1.8·0.45 rad 로 돌리고 03·05·07·09 는 한 장면을 되풀이한다.

SVG 선 그리기 애니메이션 9종 — 원형 그래프 채우기·로고 시그니처 순차·지도 경로 이동·스크롤 진행 선·하트 드로잉·손그림 흔들림·체크 표시·웨이브 3겹·다이어그램 화살표

숫자는 어디까지 실측이고 어디까지 모델인가

인용하는 값의 성격을 먼저 가른다. 경로 길이와 위치·엔진 delay 는 브라우저가 경로를 실제로 펼쳐 낸 실측이고(getTotalLength·getPointAtLength·getComputedTiming), 07 의 감쇠 진동식과 08 의 사인 생성식, 04 의 진행도 환산은 화면이 수식을 계산해 보여 주는 모델이다.

측정 환경은 헤드리스 Chromium 145.0.7632.6 이고 무대 480×300 을 2초간 24장 찍어 이웃한 두 장의 차 23개로 움직임을 판정했다. 누적면적은 시리즈 전체에서 한 번이라도 첫 컷과 달라진 화소의 몫, 강도는 그 화소들의 색 차 평균(0~255), 움직인 프레임은 바로 앞 컷과 달라진 컷의 개수다.

장면 누적면적 움직인 프레임 강도 평균
01 원형 그래프 11.2% 23/23 131.7
02 로고 시그니처 14.8% 23/23 128.3
03 지도 경로 11.7% 23/23 100.5
04 스크롤 진행 선 11.5% 23/23 146.2
05 하트 드로잉 10.0% 23/23 142.4
06 손그림 흔들림 10.0% 23/23 88.3
07 체크 스프링 14.9% 23/23 81.2
08 웨이브 3겹 17.8% 23/23 117.0
09 다이어그램 화살표 10.1% 23/23 125.7

읽는 순서는 이렇다. 누적면적은 08 의 17.8% 가 가장 넓고 05·06 의 10.0% 가 가장 좁으며, 강도 평균은 04 의 146.2 가 가장 높고 07 의 81.2 가 가장 낮다. 아홉 장면 전부 23개의 차 프레임에서 움직였다.

확인 못 한 것도 적는다. 09 의 양끝 동시 그리기는 SVG 명세상 표준 동작이지만 브라우저별 렌더 차이는 헤드리스 Chromium 하나에서만 확인했고, 08 의 겹 길이는 위상마다 달라져 한 숫자로 적지 않았다.

01원 둘레를 재해 퍼센트만큼 채우는 원형 그래프

데모와 설명

원 둘레를 반원 두 개의 A 명령으로 그려서 getTotalLength 로 재면 440.9px 가 나와 이론값 2π×70=439.8 과 오차 0.25% 안에서 들어온다.

dasharray 를 그 값으로 두고 dashoffset 을 440.9×(1−p) 로 내려 62% 를 그리면 빈칸은 38% 인 167.2px 가 되고, 같은 진행도가 두꺼운 원호 면(stroke-width 34)과 옆 채움 막대, getPointAtLength 로 좌표를 얻는 선 끝 점까지 네 표현으로 번진다.

원 둘레를 재해 퍼센트만큼 채우는 원형 그래프
전체 코드 새 창에서 열기

01 · 원 둘레를 재해 퍼센트만큼 채우는 원형 그래프 — 측정 누적면적 11.215% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

getTotalLengthdasharraypercent

코드에서 볼 곳

아래 프레임 함수가 p 하나를 링·원호 면·숫자·막대에 나눠 넣는 줄기를 보여 준다.

    function frame(t) {
        const total = OPEN_MS + DRAW_MS + HOLD_MS;
        const p = clamp((t - OPEN_MS) / DRAW_MS, 0, 1) * (curPct / 100);
        if (ringP && ringBg) {
            setDraw(ringP, curLen, p);
        }
        if (pieP) {
            // 같은 진행도를 두꺼운 원호 면으로 — 누적면적 전파 (게이트 규칙: 같은 계산 값의 확대 표현)
            pieP.setAttribute('stroke-width', '34');
            pieP.setAttribute('opacity', '0.65');
            setDraw(pieP, curLen, p * 0.999);
        }
        const shown = Math.round(p * 100);
        if (bigTxt && shown !== pctShown) {
            bigTxt.textContent = f0(shown) + '%';
            pctShown = shown;
        }

02획마다 순서를 정해 그리는 로고 시그니처

데모와 설명

로고를 획 5개(길이 합 500px)의 path 로 쪼개고 지속시간을 BASE_DUR 900 을 기준으로 길이 비례해 나눠 주면 짧은 획은 빨리 끝난다.

다음 획의 시작은 앞 획 지속시간의 절반과 STAGGER_MS 240 가운데 큰 쪽으로 미뤄, 앞 획이 절반쯤 그려졌을 때 다음 획이 들어오는 겹침이 서명의 흐름을 만든다.

획마다 순서를 정해 그리는 로고 시그니처
전체 코드 새 창에서 열기

02 · 획마다 순서를 정해 그리는 로고 시그니처 — 측정 누적면적 14.774% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

STAGGER_MSstroke-dashoffsetsequence

코드에서 볼 곳

겹침의 실측은 path.animate 의 getComputedTiming 에서 읽는다.

        for (let s = 0; s < paths.length; s += 1) {
            const dur = Math.round(BASE_DUR * lens[s] / lenMax);
            const a = paths[s].animate([{ strokeDashoffset: lens[s] }, { strokeDashoffset: 0 }], { duration: dur, delay: Math.round(t0), fill: 'both', easing: 'ease-in-out' });
            animPaths.push({ a: a, p: paths[s], delay: Math.round(t0), dur: dur, k: s });
            spans.push({ s: Math.round(t0), e: Math.round(t0) + dur, k: s % 5 });
            // 획 끝을 따라가는 점 — 같은 진행도가 점 위치를 만든다
            const dot = svgEl('circle', 'dot dot--trav', svg);
            dot.setAttribute('r', '9');
            tipDots.push(dot);
            // 왼쪽 게이지 — 획 진행도가 그대로 막대 높이가 된다 (같은 계산의 전파)
            const g = svgEl('rect', 'gauge gauge--' + s, svg);
            g.setAttribute('x', String(30 + s * 44));
            g.setAttribute('y', '150');
            g.setAttribute('width', '30');
            g.setAttribute('height', '0');
            gauges.push(g);
            t0 += Math.max(curStagger, dur / 2);
        }

03경로 위를 따라가는 이동체가 있는 지도 경로

데모와 설명

지도 경로(베지어 4개를 이은 ROUTE)의 총 길이는 472.9px 이고 이동체는 매 프레임 getPointAtLength(p×L) 좌표로 옮겨 1500ms 동안 초속 315.3px 로 지나간다.

잔상 점 5개는 p−0.035s 뒤 지점의 같은 계산이고, 점선 오버레이는 dashoffset 을 −p×L 로 놓아 점선이 이동체 방향으로 흐른다.

경로 위를 따라가는 이동체가 있는 지도 경로
전체 코드 새 창에서 열기

03 · 경로 위를 따라가는 이동체가 있는 지도 경로 — 측정 누적면적 11.678% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

getPointAtLengthprogresstraveler

코드에서 볼 곳

frame 이 이동체·잔상·점선을 한 번에 움직인다.

    function frame(t) {
        const p = clamp((t - OPEN_MS) / TRAVEL_MS, 0, 1);
        if (routeP) {
            setDraw(routeP, routeLen, p);
        }
        if (progBar) {
            progBar.style.width = clamp(p, 0, 1) * 360 + 'px';
        }
        if (glowP) {
            glowP.setAttribute('stroke-dasharray', '2 10');
            glowP.setAttribute('stroke-dashoffset', String(-p * routeLen));
        }
        if (travP && routeLen > 0) {
            const at = pointAt(ROUTE, p * routeLen);
            travP.setAttribute('cx', f1(at.x));
            travP.setAttribute('cy', f1(at.y));

04스크롤 퍼센트를 offset 산술로 바꾸는 진행 선

데모와 설명

진행도 p 에 dashoffset = 388×(1−p) 를 직접 대입해 스크롤이 선을 그리고, 스크롤을 되돌리면 선도 되돌아가는 역방향이 산술에 공짜로 얹힌다.

MAP_RANGE 프리셋 1.0·0.5 로 스크롤 거리를 조절하고 시연 화면은 0→1→0 삼각파(half 900ms)로 흔들리며 스크럽 손잡이가 같은 p 를 공유한다.

스크롤 퍼센트를 offset 산술로 바꾸는 진행 선
전체 코드 새 창에서 열기

04 · 스크롤 퍼센트를 offset 산술로 바꾸는 진행 선 — 측정 누적면적 11.494% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

scrollProgressMAP_RANGEdashoffset

코드에서 볼 곳

apply() 가 선·채움 막대·손잡이 세 표현에 같은 p 를 뿌린다.

    function apply(p) {
        if (lineP) {
            setDraw(lineP, lineLen, p);
        }
        if (fillBar) {
            fillBar.style.width = clamp(p, 0, 1) * 388 + 'px';
        }
        if (scrubKnob) {
            scrubKnob.style.left = 30 + clamp(p, 0, 1) * 374 + 'px';
        }
    }

05닫힌 하트를 그리고 색을 채우는 일러스트 드로잉

데모와 설명

닫힌 하트 경로 763.9px 를 0~1200ms 에 그리고 120ms 쉼 뒤 1320ms 부터 fill-opacity 를 0.12 에서 0.9×0.9 로 올려 색 층이 선 층 위에 얹힌다.

짝 하트는 0.75×STROKE_MS 인 900ms 부터 같은 계산을 작은 크기로 반복하고, 그리는 동안 getPointAtLength 점이 선 끝을 따라가다가 색 단계에서는 숨는다.

닫힌 하트를 그리고 색을 채우는 일러스트 드로잉
전체 코드 새 창에서 열기

05 · 닫힌 하트를 그리고 색을 채우는 일러스트 드로잉 — 측정 누적면적 10.001% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

fill-opacityclosedPathlayeredFill

코드에서 볼 곳

프레임 함수가 선·쉼·색의 세 단계를 한 시간표로 짠다.

    function frame(t) {
        const p = clamp(t / STROKE_MS, 0, 1);
        if (heartP) {
            setDraw(heartP, heartLen, p);
            // fill 은 컷 전환 — fill-opacity 가 프레임 한 장에 0 에서 0.9 로 (poster 가 이 순간을 잡는다)
            const fo = t >= STROKE_MS + GAP_MS + FILL_MS * 0.8 ? 1 : t >= STROKE_MS + GAP_MS ? 0.12 : 0;
            heartP.setAttribute('fill-opacity', String(fo * 0.9));
            if (heartDot) {
                // 그리는 동안만 점이 선 끝을 따라간다 — 색 채우기 단계에선 숨긴다
                if (t < STROKE_MS) {
                    const at = pointAt(HEART, p * heartLen);
                    heartDot.setAttribute('cx', f1(at.x));
                    heartDot.setAttribute('cy', f1(at.y));
                    heartDot.setAttribute('opacity', '1');
                }

06정점마다 어긋나는 손그림 흔들림

데모와 설명

지붕 3·몸통 4·문 4 정점 11개마다 시드 해시로 위상을 정한 ±DISTURB_PX 1.5 오프셋을 매 프레임 다시 더해 path 를 새로 만든다.

같은 시드면 같은 흔들림이 재현되어 재생할 때마다 다른 낙서가 되지 않고, 같은 해시가 격자 점 36개의 흔들림 필드에도 얹히며 진행도에 따라 getTotalLength 로 길이를 다시 재어 그린다.

정점마다 어긋나는 손그림 흔들림
전체 코드 새 창에서 열기

06 · 정점마다 어긋나는 손그림 흔들림 — 측정 누적면적 9.957% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

DISTURB_PXseedHashwobble

코드에서 볼 곳

disturbPt 와 pathOf 두 함수가 흔들림 전부를 만든다.

    function disturbPt(pt, fi, vi, t) {
        // 두 시드 해시를 섞어 위상이 다른 흔들림 — 같은 시드면 같은 흔들림이 재현된다
        const h1 = seedHash(fi * 31 + vi, 3);
        const h2 = seedHash(fi * 31 + vi, 9);
        const ph = t * 0.004;
        return [pt[0] + Math.sin(ph + h1 * 6.283) * curDisturb, pt[1] + Math.cos(ph * 1.3 + h2 * 6.283) * curDisturb];
    }
    function pathOf(fig, fi, t) {
        const pts = fig.map(function (v, vi) { return disturbPt(v, fi, vi, t); });
        return 'M ' + pts.map(function (p) { return f1(p[0]) + ' ' + f1(p[1]); }).join(' L ') + ' Z';
    }

07짧은 경로가 스프링으로 튀는 체크 표시

데모와 설명

감쇠 진동 x(t) = 1 − e^(−ζωt)·cos(ω_d·t) 을 ζ 0.20·ω 18 rad/s 로 두면 ω_d 는 17.63 이고 첫 사이클의 최대 오버슛 43.5% 는 이론 근삿값 43.7% 와 겹친다.

짧은 획 62.2px 는 p/0.3, 긴 획 131.1px 는 (p−0.25)/0.75 로 같은 스프링을 나눠 쓰고, 시연은 200ms 뒤 처음 발동해 1200ms 간격으로 반복하며 오버슛이 상자 테두리 두께와 배경 밝기로도 번진다.

짧은 경로가 스프링으로 튀는 체크 표시
전체 코드 새 창에서 열기

07 · 짧은 경로가 스프링으로 튀는 체크 표시 — 측정 누적면적 14.885% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

dampedOscovershootshortPath

코드에서 볼 곳

dampedOsc 한 줄이 목표를 넘겼다 되돌린다.

    const dampedOsc = function (tms) {
        // x(t) = 1 - e^(-z w t) cos(w_d t) — 목표 1 을 넘겼다 되돌아온다. t 는 초
        const t = tms / 1000;
        const wd = OMEGA * Math.sqrt(1 - ZETA * ZETA);
        return 1 - Math.exp(-ZETA * OMEGA * t) * Math.cos(wd * t);
    };
        if (shP && loP) {
            // 짧은 획이 먼저 그려지고(0~0.3), 긴 획이 이어진다(0.25~1) — 진행도에 같은 스프링을 얹는다
            setDraw(shP, shLen, clamp(p / 0.3, 0, 1.2));
            setDraw(loP, loLen, clamp((p - 0.25) / 0.75, 0, 1.2));
            if (boxEl) {
                boxEl.setAttribute('aria-checked', p > 0.5 ? 'true' : 'false');
                // 오버슛이 상자 테두리 두께·배경 밝기로 전파된다 (같은 계산)
                boxEl.style.borderWidth = f1(3 + Math.abs(p - 1) * 10) + 'px';
                boxEl.style.background = 'rgba(213, 218, 234, ' + f1(clamp(p, 0, 1) * 0.28) + ')';
            }
        }

08위상차를 계산해 겹치는 웨이브 라인 3겹

데모와 설명

같은 사인 경로를 위상만 k×WAVE_PHASE(0.9 rad) 씩 다르게 세 겹의 path 로 만들고 시작도 120ms + k×140ms 로 어긋나게 한다.

y = 78 + sin(0.144x + phase) × 56 × sin(π·s/60) 의 창 함수가 양끝을 0 으로 내려 꼬리가 흔들리지 않고, 60점 폴리라인이라 겹마다 잰 길이는 위상에 따라 조금씩 다르다.

위상차를 계산해 겹치는 웨이브 라인 3겹
전체 코드 새 창에서 열기

08 · 위상차를 계산해 겹치는 웨이브 라인 3겹 — 측정 누적면적 17.785% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

WAVE_PHASEsinePathphasedLayers

코드에서 볼 곳

sinePath 생성자가 세 겹을 위상만 바꿔 뽑는다.

    const sinePath = function (phase) {
        const pts = [];
        for (let s = 0; s <= SAMPLES; s += 1) {
            const x = 24 + s / SAMPLES * 400;
            const y = 78 + Math.sin(SINE_K * x * 4 + phase) * SINE_AMP * Math.sin(Math.PI * s / SAMPLES);
            pts.push(f1(x) + ' ' + f1(y));
        }
        return 'M ' + pts.join(' L ');
    };

09화살표가 차례로 이어지는 다이어그램 연결

데모와 설명

1번 화살표는 dashoffset 을 L→0 으로 정방향, 2번은 −L→0 으로 역방향(경로를 거꾸로 그린다), 3번은 dasharray 를 grow (half−grow) grow L 네 조각으로 쪼개 양끝이 같은 속도로 자라 중앙에서 만난다.

화살촉은 몸통 85% 뒤 15% 구간에 이어 그리고 relayDelay 260ms 간격·DRAW_MS 700 으로 차례를 정해 하단 막대가 이어진 수/3 을 채운다.

화살표가 차례로 이어지는 다이어그램 연결
전체 코드 새 창에서 열기

09 · 화살표가 차례로 이어지는 다이어그램 연결 — 측정 누적면적 10.083% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

relayDelaybothEndsarrowhead

코드에서 볼 곳

mode 세 갈래가 같은 계산을 다른 방향으로 쓰는 갈림길이다.

            let off;
            if (mode === 'rev') {
                // 역방향: offset 을 -L 에서 0 으로 — 선이 끝점 쪽에서 시작점으로 자란다
                off = -L + p * L;
                arrowPaths[a].setAttribute('stroke-dasharray', String(L));
                arrowPaths[a].setAttribute('stroke-dashoffset', String(off));
            }
            else if (mode === 'both') {
                // 양끝 동시: dasharray 를 절반 간격 두 쪽으로 쪼개 양끝에서 만나게 한다
                const half = L / 2;
                const grow = p * half;
                arrowPaths[a].setAttribute('stroke-dasharray', f1(grow) + ' ' + f1(half - grow) + ' ' + f1(grow) + ' ' + f1(L));
                arrowPaths[a].removeAttribute('stroke-dashoffset');
            }

선 하나가 그려지는 데 필요한 값은 무엇일까 — 총 길이·dasharray·dashoffset·지속시간

길이가 먼저다. 화면에 쓰는 L 은 전부 브라우저가 잰 값이라 소스에 박아 넣은 숫자가 하나도 없다.

장면 총 길이(L) 잰 방법
01 원형 그래프 440.9px getTotalLength, 이론 2π×70=439.8 과 오차 0.25%
02 로고 시그니처 획 5개 합 500px 획마다 getTotalLength
03 지도 경로 472.9px getTotalLength
04 스크롤 진행 선 388px 가로 직선의 getTotalLength
05 하트 763.9px Z 로 닫힌 경로의 getTotalLength
06 손그림 흔들림 매 프레임 변함 흔들린 path 를 다시 재
07 체크 62.2px·131.1px 두 획 각각
08 웨이브 3겹 겹마다 다름 60점 폴리라인의 getTotalLength
09 다이어그램 화살표 3개 각각 build 때마다 getTotalLength

지속시간과 지연은 장면마다 다른 자리에 앉는다. 01 은 열림 200ms·그리기 1500ms·유지 300ms 로 나누고, 05 는 선 1200ms·쉼 120ms·색 500ms, 07 은 200ms 뒤 발동해 1200ms 마다 반복한다.

08 은 120ms 뒤 140ms 간격으로 세 겹이 들어오고 09 는 화살표마다 260ms 간격에 700ms 그리기다. 값 넷은 이렇게 얽힌다 — L 은 재서 정하고 dasharray 는 L 과 같게, dashoffset 은 L×(1−p), p 는 시간표(01·05·07·08·09)나 시퀀스 계산(02)이나 외부 값(04 스크롤)이 만든다.

getTotalLength 로 총 길이를 재고, dasharray 를 길이와 같게 두고, dashoffset 을 길이에서 0 으로 내리는 — 선 한 획이 그려지는 순서

이 순서를 밟으면 한 획도 어렵지 않다. path 를 화면에 붙이고, getTotalLength() 로 L 을 잰 뒤 dasharray 를 L 로 둔다. 그다음 시간·스크롤·시퀀스로 p 를 만들어 dashoffset 을 L×(1−p) 로 쓰고, 필요하면 getPointAtLength(p×L) 로 선 끝 점을 얹는다.

    // 그리기 주역: dasharray 를 총 길이로 두고 dashoffset 을 길이 x (1 - p) 로 내린다
    function setDraw(p, total, p01) {
        p.setAttribute('stroke-dasharray', String(total));
        p.setAttribute('stroke-dashoffset', String(total * (1 - clamp(p01, 0, 1))));
    }

왜 이 속성 쌍인가. SVG 스트로크는 dasharray 로 그리는 조각과 건너뛰는 빈칸을 정하고 dashoffset 으로 그 패턴을 경로 위에서 민다 — dasharray 를 L 과 같게 두면 빈칸이 곧 아직 안 그린 부분이 되고, dashoffset 을 0 으로 내리면 빈칸이 경로 밖으로 밀려 나가 선이 완성된다.

그래서 그려지는 중의 어느 순간이든 L×(1−p) 하나로 표현되고, 같은 p 가 점 위치·막대·게이지로 번지는 구조도 자연히 따라온다. 물결 모양 구분선을 CSS 로 흔들고 싶으면 구분선 물결 모음이 같은 팔레트로 묶여 있다.

svg path animation css 로만 되는 것과 js 가 필요한 것 — transition 과 animation 의 경계·스크롤 연동은 어느 쪽인가

경계는 p 를 누가 만드는가다. 시간표가 처음부터 정해진 한 획은 css 만으로 된다 — stroke-dasharray 와 stroke-dashoffset 을 keyframes 나 transition 으로 움직이면 그만이라 한 바퀴짜리 연출에 충분하고, 그 예로 로딩 스피너 모음이 같은 원리를 쓴다.

js 가 필요한 순간은 셋이다. path 가 바뀌어 길이를 그때그때 재야 할 때(02·06), 스크롤 같은 외부 값을 매 프레임 넣어야 할 때, 시퀀스 겹침을 계산해야 할 때(02 의 delay 누적)다. svg line drawing animation on scroll 은 스크롤 위치가 곧 p 라 대입이 필요한 대표격이고, 04 의 시연 삼각파가 사람 스크롤을 대신할 뿐 실제 페이지에서는 스크롤값이 그 자리에 들어간다.

스크롤 축의 더 넓은 이야기는 스크롤 연동 애니메이션 가이드에 따로 정리했다. 02 는 그 사이의 선택지인데, path.animate() 로 짝을 지으면 delay 관리를 엔진에 맡기고 getComputedTiming() 으로 진행도를 되돌려 받는다 — Web Animations API 는 Chrome 84·Firefox 75·Safari 14·Edge 84·iOS 13.4 부터다.

호환은 넉넉한 편이다. SVG 자체는 Chrome 4·Firefox 3·Safari 4·Edge 12·iOS 8 부터 오래 지원됐고, getTotalLength·getPointAtLength·stroke-dasharray 는 caniuse 독립 항목이 없을 만큼 SVG 코어에 붙어 온 기능이라 'Safari 도 오래 지원' 수준으로만 말하는 게 맞다. prefers-reduced-motion 은 Chrome 74·Firefox 63·Safari 11·Edge 79·iOS 10.3 부터다.

선 그리기가 깨지는 함정 — 스트로크 속성 상속·뷰박스 스케일로 어긋나는 길이·vector-effect 로 인한 굵기 변형

getTotalLength 는 화면에 붙은 뒤에만 값을 준다

붙기 전의 경로는 브라우저가 펼쳐 보지 못해 값을 줄 수 없다. 화면 밖 오프스크린 path 로 먼저 재는 패턴 대신 이 편은 visibility:hidden 상자(probe)에 같은 viewBox 의 임시 svg 를 붙여 재고 바로 뗀다 — 아홉 장면 전부가 같은 함수로 잰다.

viewBox 를 바꾸면 probe 도 같은 값을 받아야 한다

02 는 viewBox 를 시선 영역으로 좁혀 획이 크게 보이게 하는데, getPointAtLength 좌표는 path 좌표계 그대로라 화면에는 그대로 쓸 수 있어도 probe 사본에 같은 viewBox 를 넘기지 않으면 길이와 좌표가 어긋난다 — 어긋난 채 그려지는 버그를 제작 중에 한 번 봤다.

dashoffset 의 음수는 버그가 아니라 기능이다

03 의 흐르는 점선은 dashoffset 을 −p×L 로 놓아 점선이 이동체 방향으로 흐르고, 09 의 역방향은 −L→0 으로 경로를 거꾸로 그린다. 음수 offset 은 패턴을 경로 위에서 앞으로 미는 표준 동작이라 지우려 들 것이 아니라 방향 표현으로 쓰면 된다.

단축 animation 은 delay 를 지운다

CSS 단축형 animation 은 delay 를 0 으로 리셋하는 함정이 있어 시퀀스 지연이 소리 없이 사라진다 — WAAPI 나 개별 속성(animation-delay)으로 주면 이 함정이 아예 없다.

선만 두면 화면이 좁아 보인다

선 그리기는 스트로크가 좁어 누적면적이 낮게 나온다. 같은 진행도를 막대·게이지·원호 면·이동 점으로 전파하면 논리를 바꾸지 않고 면적이 오르는데, 이 편은 그 전파로 4~10% 대에서 10.0~17.8% 까지 올랐다.

속성 쪽도 두 가지만 기억하면 된다. CSS 의 stroke-dasharray 선언은 SVG 속성으로 쓴 값을 덮어쓰니 한쪽만 고치면 어긋나고, vector-effect: non-scaling-stroke 는 굵기를 스케일에서 떼어 놓을 뿐 길이와 dashoffset 산술에는 영향을 주지 않는다. 길이·시간·이징을 폼에서 골라 내려받는 svg path animation generator 류 도구는 이 네 값의 조합을 미리 만들어 줄 뿐이라 값의 뜻을 알면 그 결과물을 직접 고칠 수 있다.

이 편의 아홉 장면 소스와 편집용 파일을 담은 zip 은 아래 상자에서 내려받고, 여는 비밀번호는 zyqdmnhk 다.

총 길이와 지속시간과 지연을 바꾸면 느낌은 얼마나 달라질까 — 시퀀스 간격·이징·시작 방향을 바꿔 본 차이

이름 바꾼 값 느낌
시퀀스 간격을 넓혀 02 STAGGER_MS 240 → 600 획별 시작이 0·600·1200·1800·2400ms 로 벌어져 마지막 획이 시작되기 전 쉼이 길어지고 한 글자가 여러 획으로 읽힌다(240 에서는 마지막 시작 1170ms·끝 2847ms, 120 에서는 서명이 한 번에 흘러 나온다)
손그림 흔들림을 세게 06 DISTURB_PX 1.5 → 4 정점 어긋남 폭이 2.7배로 커져 종이에 두 번 그은 손글씨가 된다 — 정점 (60,128)·(160,30)·(260,128) 이 60.7,129.7 → 157.2,26.2 → 260.0,126.2 로 ±4 안에서 흔들리고 0.5 는 깨끗한 잉크 선
스크롤 매핑을 가파르게 04 MAP_RANGE 1.0 → 0.5 화면 절반 스크롤로 선이 전부 그려져 반응이 빨라 보인다 — 손잡이가 같은 p 를 공유해 프리셋 전환 때는 손잡이 속도만 빨라진 것처럼 보인다

셋 다 방향키 ←→ 로 그 자리에서 바꿔 볼 수 있다. 값 하나가 여러 표현에 번지는 구조라 STAGGER_MS 를 바꾸면 게이지 높이와 차트 구간까지 같이 움직이고, DISTURB_PX 를 바꾸면 격자 점 36개의 흔들림 필드가 같은 배율로 커진다.

움직임 줄이기에서는 완성된 그림 한 장 — 그려지는 중의 알림을 문장으로 읽어 주는 접근성

모든 장면은 시간표나 스크롤로 스스로 그려져 조작 없이도 끝까지 볼 수 있다. 키보드는 Space·Enter 일시정지(버튼 aria-pressed), R 처음부터, ←→ 다른 프리셋이고 탭이 숨으면 visibilitychange 로 멈췄다가 돌아오면 이어 간다.

알림은 아껴 쓴다. 매 프레임 바뀌는 상태 줄은 aria-live="off" 로 읽지 않고, role="status" 낭독 문장은 일시정지·프리셋 전환 때만 갱신한다. 일시정지는 <button>, 장면 상자는 role="img" 와 aria-label 을 달고 07 은 aria-checked 로 체크 상태를 알린다.

움직임 줄이기가 켜지면 SCSS 가 .ez * { animation: none !important } 로 애니메이션을 전부 끄고 JS 는 완성 프레임 한 장을 그린다 — 이때 document.getAnimations().length 는 0 으로 실측됐다.

        if (reduced) {
            // 움직임 줄이기 — 모든 애니메이션이 꺼지고 장면은 완성 상태 한 장이다 (build 마지막 프레임을 그린다)
            statusP.textContent = '움직임 줄이기 켜짐 · 완성 상태';
            readB.textContent = '그려지는 과정 대신 완성된 그림을 바로 보여 준다';
            doneP.textContent = readB.textContent;
            cfg.frame(1e9);
        }

SVG 선 그리기 FAQ — css만으로 되나 / 길이를 모를 때 / 아이콘 폰트로도 되나 / 반응형에서 깨지면

svg path animation codepen 예제처럼 css 만으로 선을 그릴 수 있나요?

한 획을 정해진 시간에 그리는 것은 css 만으로 됩니다 — dasharray·dashoffset 을 keyframes 로 움직이면 그만입니다. 다만 총 길이는 미리 알아야 해서 처음 한 번은 js 로 getTotalLength 를 불러야 하고, 스크롤 연동·시퀀스 겹침은 매 프레임 값이 필요해 js 쪽입니다.

경로의 총 길이를 모를 때는 어떻게 하나요?

요소를 화면에 붙인 뒤 getTotalLength() 로 잰다 — 붙기 전에는 값을 줄 수 없어 이 편은 visibility:hidden probe 상자를 쓴다(함정 절 참고). 원 둘레 440.9px처럼 브라우저가 잰 값을 그대로 쓰면 곡률·굵기를 고쳐도 길이가 따라간다.

반응형에서 선 그리기가 어긋나면 무엇을 고치나요?

viewBox 스케일과 probe 의 viewBox부터 맞춘다 — 좌표는 path 좌표계 그대로라 메인 svg 와 probe 가 같은 viewBox 를 쓰면 화면 크기와 무관하게 어긋나지 않는다. 다음으로 CSS stroke-* 선언이 속성값을 덮었는지 보고, 다중 조각 dasharray(09 양끝 동시)는 브라우저별 렌더 차이가 있어 실제 브라우저에서 확인한다.

출처: SVGGeometryElement.getTotalLength·SVGGeometryElement.getPointAtLength·stroke-dasharray·prefers-reduced-motion

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

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