はじめに
ファイルの送信や準備状況は、完了までの目安が分かるだけで待ちやすくなります。円形プログレスは小さな領域で進み具合を伝えられる部品です。ただし、進捗を測れない処理に架空の数値を付ける用途には使いません。
今回作るもの
ボタンやスライダーで進捗を変えると、円の線が指定値へ伸び縮みします。オーブを使った既存のローディング演出とは、トリガーが数値更新であること、主役が1本の円周であることが異なります。図形はSVGで描き、外部画像を必要としません。
コンポーネント設計
Demoがサンプル値と操作UIを持ち、ProgressRingは受け取った値を表示します。実際の通信処理はリングの外側で管理する想定です。この分離により、アップロードでもチェックリストでも同じ表示部品を利用できます。
実装のポイント
円にpathLength="100"を指定し、線の長さを100基準として扱います。stroke-dasharray: 100 100で線と空白を1周ずつ用意し、strokeDashoffsetを100 - valueにします。値が65ならオフセットは35です。こうすると半径を変えても進捗の計算式を保てます。MDNのpathLengthに正規化の考え方が説明されています。
線の始点はSVG全体を-90度回転して上へ移します。数値はHTMLで重ねるので回転しません。0%で線端の小さな点が残らないよう、線端はbuttを選んでいます。
420msの補間は、値が大きく変わったことを見て取るためのものです。数値とaria-valuenowは実際の値へ即時更新し、線だけがその値へ追いつきます。中間フレームごとの読み上げを避けるため、aria-liveは付けていません。線の移動を減らす設定では補間も停止します。
使いどころとカスタマイズ
実データを渡すときは、呼び出し側で有限の数値かを確認し、0〜100へ収めます。総量が不明なら別の不定進捗表示に切り替えてください。頻繁に更新される値ならtransitionを短くして、見た目の遅れを抑えます。
このデモはタイマーを使わないためcleanupは不要です。通信へ接続した場合は、購読解除やリクエストの中断をデータ取得側で実装します。0%、100%、連続操作、動きを減らす設定を確認すれば、端点と補間の振る舞いを検証できます。
発展させるなら
完了時に一度だけメッセージを通知する仕組みを追加できます。通知は線のアニメーション終了ではなく、実際の処理完了を基準にしてください。