線画 アニメーション 9種 — SVGのstroke-dashoffset計算からスクロール連動まで
線画 アニメーションとは、SVGのパスが少しずつ描かれていく演出のことで、線が引かれるとは破線の空白を押す計算のことです — 01番は円周の長さを測って%だけ埋め、03番はgetPointAtLengthで経路上の移動体の位置を毎フレーム計算し、04番はスクロールの割合をdashoffsetの計算に変えます。
SVG線描画アニメーションは絵ではなく、stroke-dasharrayで作った破線の空白をstroke-dashoffsetで押す計算です
01 ld-ring-progress-length
02 ld-logo-signature-sequence
03 ld-map-route-getpointatlength
04 ld-scroll-progress-offset
05 ld-heart-illustration-fill
06 ld-handdrawn-disturbance
07 ld-checkmark-spring
08 ld-wave-phased-layers
09 ld-diagram-arrow-relay
- 01 円周を測って%だけ埋める円グラフ
- 02 筆ごとに順番を決めて引くロゴシグネチャ
- 03 経路の上を進む移動体のある地図経路
- 04 スクロールの割合をoffsetの計算に変える進行線
- 05 閉じたハートを描いて色を塗るイラスト
- 06 頂点ごとにずれる手描きの揺れ
- 07 短い経路がばねで跳ねるチェック印
- 08 位相差を計算して重なる三枚の波線
- 09 矢印が順につながるダイアグラムの接続
九つの場面は同じ舞台の上で回ります。内側の箱は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種 — 円グラフの塗り・ロゴシグネチャの順番・地図経路の移動・スクロール進行線・ハートのドローイング・手描きの揺れ・チェック印・三枚の位相の波線・ダイアグラムの矢印
数字はどこまで実測でどこまでモデルか
引用する値の性質を先に分けます。経路の長さと位置・エンジンの遅延は、ブラウザが経路を実際に広げて出した実測値です(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 三枚の波線 | 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 で座標を取る線の終点の点まで、四つの表現へ広がります。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="円グラフが円周を測って目標の割合まで埋め、横の棒も同じ値で満ちる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 421줄 — 아래 「전체 코드」에서 원문 전체)// RingLength - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./RingLength.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 409줄 — 아래 「전체 코드」에서 원문 전체)01 · 円周を測って%だけ埋める円グラフ — 計測 累積面積 11.215% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
下のビルド関数が、円周を測って各部品に同じ長さを配る幹の部分です。
function build(i) {
curPct = PRESETS[i];
const svg = makeSvg();
ringBg = svgPath(svg, 'st st--dim', 'M ' + (RING_CX - RING_R) + ' ' + RING_CY + ' A ' + RING_R + ' ' + RING_R + ' 0 1 1 ' + (RING_CX + RING_R) + ' ' + RING_CY + ' A ' + RING_R + ' ' + RING_R + ' 0 1 1 ' + (RING_CX - RING_R) + ' ' + RING_CY);
ringP = svgPath(svg, 'st st--a', ringBg.getAttribute('d'));
curLen = ringP ? ringP.getTotalLength() : 0;
setDraw(ringP, curLen, 0);
// 線の終点を追う点 — getPointAtLength で毎フレーム位置を計算する (値の伝播: 同じ進みが点の位置も作る)
haloDot = svgEl('circle', 'dot dot--trav', svg);
haloDot.setAttribute('r', '21');
// リング内側のパイ切片 — 同じ%を面で示す (conic の代わりに stroke 太さ 30 の円弧)
pieP = svgPath(svg, 'st st--b s1__pie', ringBg.getAttribute('d'));
bigTxt = svgText(svg, 'svtx svtx--big', RING_CX, 88, '0%');
// 横の進行棒 — リングの%と同じ値で満たす (グループ箱: 幅26px x 高さ8px)
const gx = 188;
for (let g = 0; g < 8; g += 1) {
02筆ごとに順番を決めて引くロゴシグネチャ
デモと説明
ロゴを五つの筆(長さの合計500px)のpathに分け、持続時間をBASE_DUR 900を基準に長さ比例で割ると、短い筆は早く終わります。
次の筆の開始は、前の筆の持続時間の半分とSTAGGER_MS 240のうち大きい方へ遅らせます。前の筆が半分描けたときに次の筆が入ってくる重なりが、署名の流れを作ります。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="抽象ロゴの五つの筆がそれぞれの長さに合った持続時間と決めた間隔で順に入り描かれる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 423줄 — 아래 「전체 코드」에서 원문 전체)// SignatureSequence - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SignatureSequence.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 417줄 — 아래 「전체 코드」에서 원문 전체)02 · 筆ごとに順番を決めて引くロゴシグネチャ — 計測 累積面積 14.774% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
重なりの実測は path.animate の getComputedTiming から読みます。下のループが長さ比例の持続時間と遅延の累積を組み立てます。
const spans = [];
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);
}
const total = Math.round(t0 + 400);
03経路の上を進む移動体のある地図経路
デモと説明
地図の経路(ベジェ四つをつないだROUTE)の全長は472.9pxで、移動体は毎フレーム getPointAtLength(p×L) の座標へ移り、1500msのあいだに毎秒315.3pxで通り過ぎます。
残像の点5個はp−0.035s後ろの地点の同じ計算です。点線の重ねはdashoffsetを−p×Lに置くので、点線が移動体の方向へ流れます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="曲がった経路が手前から描かれ、移動体が経路上の位置を毎瞬間計算して追う場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 407줄 — 아래 「전체 코드」에서 원문 전체)// MapTraveler - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./MapTraveler.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 393줄 — 아래 「전체 코드」에서 원문 전체)03 · 経路の上を進む移動体のある地図経路 — 計測 累積面積 11.678% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
ビルド関数が、経路と移動体と残像の点を同じ長さLの上に並べます。
function build(i) {
const svg = makeSvg();
routeP = svgPath(svg, 'st st--a', ROUTE);
routeLen = routeP.getTotalLength();
setDraw(routeP, routeLen, 0);
glowP = svgPath(svg, 'st st--dim', ROUTE);
travP = svgEl('circle', 'dot dot--trav', svg);
travP.setAttribute('r', '14');
// 移動体の後ろに続く残像点5個 — 同じ getPointAtLength の計算を後ろの地点に当てはめる
trailDots = [];
for (let s = 0; s < 5; s += 1) {
const td = svgEl('circle', 'dot dot--dep', svg);
td.setAttribute('r', String(9 - s));
td.setAttribute('opacity', String(0.5 - s * 0.09));
trailDots.push(td);
04スクロールの割合をoffsetの計算に変える進行線
デモと説明
進みpに dashoffset = 388×(1−p) を直接当てはめると、スクロールが線を引きます。スクロールを戻せば線も戻る逆向きが、計算にただで付いてきます。
MAP_RANGEのプリセット1.0・0.5でスクロールの距離を調整します。デモの画面は0→1→0の三角波(半周期900ms)で動き、スクラブのつまみが同じpを共有します。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="スクロール値を表すつまみが左右に動き、その値がそのまま線の描かれた量になる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 389줄 — 아래 「전체 코드」에서 원문 전체)// ScrollProgress - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ScrollProgress.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 375줄 — 아래 「전체 코드」에서 원문 전체)04 · スクロールの割合をoffsetの計算に変える進行線 — 計測 累積面積 11.494% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
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';
}
}
function build(i) {
curRange = i === 0 ? 1.0 : 0.5;
05閉じたハートを描いて色を塗るイラスト
デモと説明
閉じたハートの経路763.9pxを0〜1200msで描き、120msの休みのあと1320msからfill-opacityを0.12へ上げ、0.9×0.9まで広げて色の層が線の層の上に載ります。
相手のハートは0.75×STROKE_MSの900msから同じ計算を小さい大きさで繰り返します。描いているあいだ getPointAtLength の点が線の終点を追い、色の段階では隠れます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="閉じたハートがまず線として完成し、そのあと色が満ちる二段階でイラストが完成する場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 402줄 — 아래 「전체 코드」에서 원문 전체)// HeartFill - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./HeartFill.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 395줄 — 아래 「전체 코드」에서 원문 전체)05 · 閉じたハートを描いて色を塗るイラスト — 計測 累積面積 10.001% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
フレーム関数が線・休み・色の三段階を一つの時間割に組みます。
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 で長さを測り直して描きます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="家の絵の頂点ごとにシードで決まったずれが毎瞬間足し直され、手で二度なぞった線になる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 409줄 — 아래 「전체 코드」에서 원문 전체)// HanddrawnDisturb - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./HanddrawnDisturb.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 403줄 — 아래 「전체 코드」에서 원문 전체)06 · 頂点ごとにずれる手描きの揺れ — 計測 累積面積 9.957% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
フレーム関数が、揺らしたpathの長さを毎フレーム測り直して描く流れです。
function frame(t) {
const p = clamp(t / WOBBLE_MS, 0, 1);
for (let f = 0; f < FIGS.length; f += 1) {
const wp = wobblePaths[f];
wp.setAttribute('d', pathOf(FIGS[f], f, t));
const ln = wp.getTotalLength();
setDraw(wp, ln, p);
}
// 格子点も同じハッシュのずれを共有する
for (let gi = 0; gi < fieldDots.length; gi += 1) {
const gxn = gi % 6;
const gyn = Math.floor(gi / 6);
const bx = 40 + gxn * 20;
const by = 100 + gyn * 10;
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間隔で繰り返し、行き過ぎは箱の縁の太さと背景の明るさにも広がります。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="チェック印が減衰振動で目標をわずかに越えて戻り、正しい位置に落ち着く場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 419줄 — 아래 「전체 코드」에서 원문 전체)// CheckSpring - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CheckSpring.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 408줄 — 아래 「전체 코드」에서 원문 전체)07 · 短い経路がばねで跳ねるチェック印 — 計測 累積面積 14.885% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
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);
function frame(t) {
// .is-demo 自動演出: 200ms 後にばねが発動、1200ms 間隔で繰り返し再生 (チェックを押しては戻す繰り返し)
const PERIOD = 1200;
const cycleN = Math.floor(Math.max(0, t - 200) / PERIOD);
const st = springStart < 0 ? -1 : (t - 200) % PERIOD;
if (springStart < 0 && t >= 200) {
08位相差を計算して重なる三枚の波線
デモと説明
同じサインの経路を、位相だけk×WAVE_PHASE(0.9 rad)ずつ変えた三つのpathとして作り、開始も120ms + k×140msでずらします。
y = 78 + sin(0.144x + phase) × 56 × sin(π·s/60) という窓の関数が両端を0へ下げるので、端が揺れません。60点のポリラインなので、各層の長さは位相によって少し違います。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="位相だけずれた三枚のサイン曲線が時差で順に描かれ、上品に重なる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 388줄 — 아래 「전체 코드」에서 원문 전체)// WavePhased - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./WavePhased.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 380줄 — 아래 「전체 코드」에서 원문 전체)08 · 位相差を計算して重なる三枚の波線 — 計測 累積面積 17.785% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
フレーム関数が三つの層の開始時刻をずらして同じ計算を回します。
function frame(t) {
let drawn = 0;
for (let k = 0; k < 3; k += 1) {
const p = clamp((t - 120 - k * 140) / DRAW_MS, 0, 1);
setDraw(wavePaths[k], waveLens[k], p);
if (p >= 1) {
drawn += 1;
}
}
return fill('今 {a}ms · 完成した層 {b}/3', f0(t), f0(drawn));
09矢印が順につながるダイアグラムの接続
デモと説明
一つ目の矢印はdashoffsetをL→0へ正方向に下げ、二つ目は−L→0へ逆方向に動かします(経路を逆に読みます)。三つ目はdasharrayをgrow (half−grow) grow Lの四つに分けて両端から同じ速さで伸び、中央で出会います。
矢尻は胴体の85%のあとの15%の区間に続けて描き、relayDelay 260ms間隔・DRAW_MS 700で順番を決めます。下の棒はつながった本数/3を満たします。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ダイアグラムの矢印が正方向と逆方向と両端同時で描かれ、最後に一つにつながる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
// SVG 선 그리기 장면 공통 — 먹 무대 위 파스텔 스트로크. 파스텔 변형값(BD26): vivid 토큰 직용 금지
$panel: mix($subject-cream, $subject-ink, 10%);
$grid: mix($subject-cream, $subject-ink, 7%);
$line: mix($subject-cream, $subject-ink, 26%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 스트로크 팔레트 — vivid 토큰(채도 .55+) 대신 이 값들을 쓴다 (BD26)
$stroke-blue: #d5daea; // $subject-blue 의 파스텔
$stroke-rose: #ebd6db; // 핑크 계열 파스텔
… (총 312줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 437줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
const SVGH = 156;
… (총 467줄 — 아래 「전체 코드」에서 원문 전체)// ArrowRelay - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ArrowRelay.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// 무대 좌표 — 안쪽 상자는 늘 480x300 이고 화면 폭에 맞춰 통째로 줄인다
const W = 480;
const CX0 = 8;
const CW = 432;
const SVGW = 448;
… (총 448줄 — 아래 「전체 코드」에서 원문 전체)09 · 矢印が順につながるダイアグラムの接続 — 計測 累積面積 10.083% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードのどこを見るか
modeの三つに分かれた道が、同じ計算を違う向きで使う分かれ道です。
function frame(t) {
let done = 0;
for (let a = 0; a < arrowPaths.length; a += 1) {
const st = 120 + a * relayDelay;
const p = clamp((t - st) / DRAW_MS, 0, 1);
const L = arrowLens[a];
const mode = arrowModes[a];
let off;
// 逆方向: offset を -L から 0 へ — 線が終点側から始点へ向かって伸びる
if (mode === 'rev') {
off = -L + p * L;
arrowPaths[a].setAttribute('stroke-dasharray', String(L));
arrowPaths[a].setAttribute('stroke-dashoffset', String(off));
}
// 両端同時: dasharray を半分の間隔の二つに分け、両端から出会わせる
else if (mode === 'both') {
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');
}
// 矢尻は胴体が描き終わったあと短く続けて描かれる
else {
setDraw(arrowPaths[a], L, p);
}
一本の線が引かれるのに必要な値はいくつあるか — 全体の長さ・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 三枚の波線 | 層ごとに違う | 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が点の位置・棒・ゲージへ広がる構造も自然に付いてきます。svg 線 を 引く アニメーションの作り方を確かめたいとき、波型の区切り線をCSSで揺らす波の区切り線のまとめが同じパレットでまとまっています。
cssだけでできることとjsが要ること — transitionとanimationの境界・スクロール連動はどちら側か
境界は、pを誰が作るかです。時間割が初めから決まっている一筆はcssだけでできます — stroke-dasharrayとstroke-dashoffsetをkeyframesかtransitionで動かせば済むので、一回きりの演出には十分です。その例としてローディングスピナーのまとめが同じ原理を使っています。
jsが要る瞬間は三つあります。pathが変わって長さをそのたびに測り直すとき(02・06)、スクロールのような外部の値を毎フレーム入れるとき、順番の重なりを計算するとき(02の遅延の累積)です。スクロールに連動する線描画はスクロール位置がそのままpなので、代入が必要な代表です。04のデモの三角波は人のスクロールの代わりを務めるだけで、実際のページではスクロールの値が同じ席に入ります。
スクロール軸のより広い話はスクロール連動アニメーションのガイドに別にまとめました。
02はその間の選択肢です。path.animate() で組むと遅延の管理をエンジンに任せて 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からです。
線描画が壊れる落とし穴 — ストローク属性の継承・viewBoxの縮尺でずれる長さ・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は遅延を消す
CSSの短縮形 animation は遅延を0へ戻す落とし穴があり、順番の遅延が音もなく消えます — WAAPIか個別の属性(animation-delay)で与えると、この落とし穴は最初からありません。
線だけでは画面が狭く見える
線描画はストロークが細いので累積面積が低く出ます。同じ進みを棒・ゲージ・円弧の面・移動する点へ広げると、論理を変えずに面積が上がります。この記事はその伝播で4〜10%の帯から10.0〜17.8%まで上がりました。
属性の側は二つだけ覚えます。CSSの stroke-dasharray の宣言はSVGの属性に書いた値を上書きするので、片方だけ直すとずれます。vector-effect: non-scaling-stroke は太さを縮尺から切り離すだけで、長さとdashoffsetの計算には影響しません。
フォームで長さ・時間・イージングを選んで受け取る svg アニメーション パスの生成ツール類は、この四つの値の組み合わせを先に作ってくれるだけなので、値の意味が分かればその結果を自分で直せます。
九つの場面のソースと編集用のファイルをまとめた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と実測されました。
// 動きを減らす — すべてのアニメーションが切れ、場面は完成状態の一枚 (build の最後のフレームを描く)
statusP.textContent = '動きを減らす設定 · 完成状態';
readB.textContent = '描かれる過程の代わりに完成した絵をすぐ表示する';
doneP.textContent = readB.textContent;
cfg.frame(1e9);
SVG線描画のFAQ — cssだけでも動くか・長さがわからないとき・アイコンフォントでもできるか・レスポンシブで壊れるとき
svg 線 を 引く アニメーションは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









