はじめに
手順やつながりを伝える図では、完成した線を一度に見せるより、始点から順に描くことで読む方向を示せます。今回は地図全体の演出ではなく、1本の曲線を描く最小部品を作ります。
今回作るもの
出発点と到着点を結ぶオリジナルのSVGパスを描画します。初回表示と「もう一度描く」ボタンで再生します。既存の背景パーティクルとは、主役が1本の線であること、動きが繰り返し続けず到着点で止まることが異なります。
写真や地図素材は使いません。座標を自分で定義した抽象的なルートなので、特定の場所を示す地図としての意味はありません。
コンポーネント設計
ROUTEが形状、RouteDrawingがSVGの表示、Demoが再生操作を担当します。時間制御はCSSのkeyframesへ任せます。常時動作するJavaScriptループを作らず、表示の範囲だけで完結させています。
実装のポイント
薄いガイド線と、その上を描く明るい線に同じdを指定します。ガイドが残るため、描画途中でもルート全体を把握できます。主線はpathLength="1"で長さを正規化し、破線の線と空白をそれぞれ1にします。
stroke-dashoffsetを1から0へ変えると、空白だった部分へ線が現れます。ここではパーセントを使わず数値を指定します。パーセントはパス全長そのものを基準にしないためです。仕様の説明はMDNのstroke-dashoffsetを参照してください。
再生時は主線のkeyだけを更新します。主線のDOMが作り直され、CSSアニメーションが先頭から始まります。ボタンのDOMは維持するので、キーボードフォーカスが失われません。クリック連打も現在の線を先頭へ戻す動作になります。
1.8秒のease-in-outで始点と終点をゆっくり見せます。これは移動の説明用で、実際の距離や所要時間は表していません。均等な線の進行が必要ならlinearに変更します。
使いどころとカスタマイズ
手順図、工程の接続、図解の注目線に向いています。ROUTEの座標を変えると形を、stroke-widthを変えると線の強さを調整できます。viewBoxから線や端点がはみ出さないように余白も確保してください。
CSSによる線の更新にも描画負荷はあるため、複雑なパスを大量に同時再生する場合は実機で確認します。タイマーやイベント購読がなく、明示的なcleanupは不要です。動きを減らす設定では最終状態を即時表示します。再生連打、画面縮小、動きを減らす設定を確認してください。
発展させるなら
閲覧領域へ入った瞬間に一度だけ再生する構成へ変更できます。その際はIntersectionObserverの処理を別のフックへ分け、アンマウント時にdisconnect()する責務を追加します。