円形プログレスバーの仕組み|SVGと円周の計算式

公開ツールCSS円形プログレスバー生成ツール

目次
  1. 円形プログレスバーは、なぜドーナツのように埋まって見えるのか
  2. 確認する方法: 円周の計算から自分で描く
  3. つまずきやすいポイント
  4. まとめ
  5. 中核となる技術メカニズム: SVGとCSSの数学的な原理
  6. 円形UIの実装方法の比較分析表
  7. 円形プログレスSVGを作るときにやりがちな5つのミス
  8. 失敗しない円形プログレスバー制作の5ステップ
  9. SVGアニメーションのヒント7選
  10. 技術選択ツリー: どの方式が向いている?
  11. 主要用語ミニ辞典 (Terminology Cheatsheet)
  12. よくある質問

アプリのローディング画面やダッシュボードの統計カードで、円形プログレスバーがドーナツのようにじわじわと埋まっていくのを見たことがあるでしょう。これはあらかじめ用意した画像や動くGIFではなく、SVGの円を1つ、その枠線を部分的に描くことで作った結果です。仕組みがわかれば、ライブラリなしでもコードで再現できます。

まとめ ① 円形プログレスバーは画像ではなく、SVGのcircle要素の枠線(stroke)です ② stroke-dasharrayで線を円周の全長と同じ長さだけ引き、stroke-dashoffsetで見えない区間を押し出します ③ 円周(2πr)と進捗率さえわかれば、この2つの値は自分で計算できます

円形プログレスバーは、なぜドーナツのように埋まって見えるのか

SVGのcircle要素は、もともとfill(内側の塗り)とstroke(枠線)を別々に持ちます。fillを透明にしてstrokeだけを太く塗るとドーナツ型のリングができ、このリングを2枚重ねて、下は薄い背景の円、上は進捗率の分だけ見える色の円、という構成にします。

上の円が「進捗率の分だけ」見えるのは、stroke-dasharrayという属性のおかげです。本来は点線を描くときに使う属性で、線を引いて(dash)空けて(gap)を繰り返しますが、この値に円周の全長をぴったり入れると、dash1つがちょうど円1周分と同じになり、途切れのない一本の線のように見えます。

さらにstroke-dashoffsetを加えると、その線の開始位置を円周方向にずらせます。線の長さからオフセットの分だけ押し出すと、その分が円の反対側に隠れて一部だけ埋まったように見え、transformで円を-90度回転させると、開始点が3時の方向ではなく12時の方向になります。

確認する方法: 円周の計算から自分で描く

数行のコードで、ライブラリなしでも計算できます。まず半径(r)は、円の直径から線の太さの半分を引いた値です。線は円の中心線に沿って描かれるため、線の太さの分だけ内側の余白を確保しないと、2つの円が重なってしまいます。

半径が求まれば、円周は「2 × π × r」の式で計算します。たとえば直径120px、線の太さ8pxなら、半径は56px、円周は約351.86pxになり、この値をそのままstroke-dasharrayに入れると、円全体が1本の実線のように描かれます。

進捗率を反映するには、stroke-dashoffsetを「円周 × (1 − 進捗率 ÷ 100)」で計算します。進捗率が75%なら、351.86 × 0.25、つまり約87.96pxをオフセットに入れればよいことになります。この2つの値と-90度の回転をcircleタグに入れるだけで、ドーナツ型のプログレスバーが完成します。

私たちの無料ツールで確認してみましょう。 進捗率・太さ・サイズをスライダーで変えるたびに円周とオフセットが自動で再計算されるので、値を手で計算し直さなくても、結果とコードをすぐに確認できます。

CSS円形プログレスバー生成ツール

無料・登録不要・ブラウザ上ですぐにSVG・CSSコードを生成

つまずきやすいポイント

状況原因
進行方向が逆に進むstroke-dashoffsetの計算の符号を逆に入れた、または回転方向を誤ったケースです
開始点が上ではなく右(3時)にあるcircleにtransform: rotate(-90deg)を指定していない状態です
背景の円と進捗の円で線の太さの中心がずれる半径の計算で線の太さの半分を引いていないケースです
進捗率が変わるときにカクッと途切れて見えるstroke-dashoffsetにtransitionをかけていないため、アニメーションなしで値だけが変わるケースです

表にまとめたとおり、ずれる原因はほとんどがオフセットの符号か回転方向のどちらかです。計算式と-90度の回転を一度決めておけば、あとは進捗率の数字を変えるだけで済みます。

まとめ

円形プログレスバーは画像ではなく、SVG circleの枠線をstroke-dasharrayで円周の全長と同じ長さだけ引き、stroke-dashoffsetで見えない区間を押し出すことで作ります。円周(2πr)と進捗率さえあれば、どちらの値も計算で求められます。

毎回半径と円周を手で計算する代わりに、スライダーで値を変えながらコードがどう変わるかをすぐに確認すれば、ミスを減らせます。

CSS円形プログレスバー生成ツール

無料・登録不要・ブラウザ上ですぐにSVG・CSSコードを生成


中核となる技術メカニズム: SVGとCSSの数学的な原理

単純に見えるドーナツ型グラフの裏には、精密な幾何学とCSSの物理が隠れています。

SVG円の幾何学と枠線の数学(Geometry & Stroke Math)

  • SVG全体の規格: W × H(例: 120 × 120px)
  • 線の太さ(Stroke Width): S(例: 8px)
  • 安全な半径(Radius): 線は中心を基準に両側へ広がるため、r = W/2 − S/2 = 60 − 4 = 56px
  • 円周(Circumference): C = 2π r ≈ 2 × 3.14159265 × 56 ≈ 351.86px

CSS Dash属性の物理エンジン(Physics)

  • 'stroke-dasharray: C C': 点線の1つの断片(dash)の長さを円の全周と同じに設定し、実線のように見せます。
  • 'stroke-dashoffset: C \times (1 - P / 100)': Pが進捗率(%)のとき、この値の分だけ実線の開始位置を円周に沿って押し出します。押し出された部分は見えないため、欲しいパーセントの分だけ色が塗られたような効果が生まれます。

座標系の回転とアンチエイリアシング(Rotation & Anti-aliasing)

  • SVGのデフォルトの0度の基準点は、幾何学の慣例に従って3時の方向(x=r, y=0)です。
  • これを12時の方向(上端)から始めたい場合は、CSSで 'transform: rotate(-90deg);' と回転の中心軸 'transform-origin: center;' を指定する必要があります。
  • なめらかに埋まるアニメーションは 'transition: stroke-dashoffset 0.6s cubic-bezier(0.4, 0, 0.2, 1);' で実装し、線の端を丸く仕上げるために 'stroke-linecap: round;' を使います。

円形UIの実装方法の比較分析表

円形プログレスバーを実装する複数の技術を比較してみました。

比較項目純粋なSVG + CSS(推奨)HTML5 Canvas 'arc()'CSS 'conic-gradient' / マスクAnimated GIF / Lottie
ファイルサイズ非常に小さい(約2KB)小さい小さい大きい(数十KB〜MB単位)
ベクター拡張性無限にスケーリングでき、崩れない解像度(DPI)によって崩れることがある無限にスケーリングGIFはピクセルが崩れる / Lottieは無関係
CPU/GPU負荷非常に低い(GPUアクセラレーションが効きやすい)スクリプト演算によるCPU負荷が発生低いGPUメモリの占有とCPUレンダリングの負荷が大きい
CSSアニメーション'stroke-dashoffset'でなめらかに適用JSの'requestAnimationFrame'が必要'@property'が必要(旧ブラウザでは制約あり)不可 / ライブラリに依存
ブラウザ互換性IEを含むほぼすべてのブラウザほぼすべてのブラウザ最新ブラウザ中心(一部サポート)IE対応(Lottieは最新環境に限る)

円形プログレスSVGを作るときにやりがちな5つのミス

  1. 半径から線の太さの半分を引かないミス: SVGの枠線はパスの中心線に沿って両方向に伸びます。これを引かないと、外側の半分がviewBoxの外にはみ出して切れてしまいます。
  2. -90度回転時の「transform-origin: center」の指定漏れ: 回転の中心軸を設定しないと、SVGのデフォルトである0,0座標(左上)を基準に円が画面の外へ飛んでいってしまいます。
  3. 「stroke-linecap: round」の省略: 進捗ゲージの端が刃物で切ったように平らになり、古臭いUIに見えてしまいます。
  4. 低精度な円周率(π = 3.14)のハードコード: 円周を不正確に計算すると、進捗100%に達したときに始点と終点の間にわずかな隙間(Gap)ができたり、重なったりします。JSの「Math.PI」を使いましょう。
  5. CSSの「transition」の指定漏れ: データが変わるとゲージが途切れ途切れに瞬間移動します。オフセットプロパティに適切なトランジションを指定して、滑らかなフィードバックを発生させましょう。

失敗しない円形プログレスバー制作の5ステップ

  1. サイズとビューボックスの定義: 全体のサイズ(例: 100x100)を決め、SVGの「viewBox="0 0 100 100"」を設定します。
  2. 安全な半径の導出: 線の太さ(例: 10)を決めたら、式 r = (D − stroke) / 2 に従って r = 45 を求めます。
  3. 円周長の計算: C = 2π r の公式を使って円周全体の長さを計算します。(2 × 3.14159 × 45 = 282.74)
  4. 背景トラックとインジケーターの配置: 同じサイズの円を2つ重ね、下側は淡い色のトラック、上側は進捗率の色のインジケーターとして塗ります。
  5. CSSトランジションとオフセットの適用: パーセンテージの式に従って「stroke-dashoffset」を計算し、インラインスタイルで注入し、トランジションでアニメーションを完成させます。

SVGアニメーションのヒント7選

  1. 丸い端の処理: モダンで洗練されたUIにするため、「stroke-linecap: round」を常に習慣にしましょう。
  2. グラデーションで塗る: 単色ではなく「<defs><linearGradient>」を宣言し、「stroke="url(#gradient)"」を指定して華やかな効果を演出しましょう。
  3. ハードウェアアクセラレーション: アニメーションのフレーム落ちを防ぐため、ゲージの円要素に「will-change: stroke-dashoffset」を付与しましょう。
  4. 100%状態の安定性: 100%のときに「stroke-dashoffset: 0」になるように保証して、わずかな誤差も生じないようにします。
  5. 目盛り(メーター)風のスタイル: 「stroke-dasharray」を円周長とギャップに分割(例: 「5 10」)すると、連続した実線ではなく自動車の計器盤のような点線ゲージを作れます。
  6. 半円型ゲージ: 円周を半分に割って下側を切り取り、ビューボックスとオフセットの式を半円に合わせれば、スピードメーターのようなUIが完成します。
  7. ジェネレーターを積極的に活用: 誤差のないレンダリングを確認するには、毎回手で計算するよりも、Webのジェネレーターツールでスライダーをリアルタイムに動かしてテストしましょう。

技術選択ツリー: どの方式が向いている?

  • データ可視化などインタラクションが多く、CSSアニメーションが主役か? ➔ SVGの「stroke-dashoffset」方式(おすすめ)
  • パーティクル効果(Particle)や毎秒60フレーム以上のピクセル操作が必要か? ➔ HTML5 Canvasレンダリング
  • IE対応が不要で、コードを極限まで減らしたい静的グラフか? ➔ CSS「conic-gradient」方式
  • 開発者なしでデザイナーだけで複雑なモーショングラフィックスを入れたいか? ➔ Lottie / アニメーションGIF

主要用語ミニ辞典 (Terminology Cheatsheet)

  • SVG (Scalable Vector Graphics): 数学的な方程式で描かれるため、どれだけ拡大しても劣化しない2次元ベクターグラフィック形式。
  • stroke-dasharray: 線の長さと間隔を指定して、実線を点線の断片に分割するプロパティ。ここでは円の円周全体を1本の点線にします。
  • stroke-dashoffset: 点線の開始位置をずらすオフセットプロパティ。進捗率に反比例するように設定して、残りの空き区間を演出します。
  • 円周(Circumference, 2πr): 円の縁全体の長さ。プログレスバーの100%の長さになります。
  • viewBox: SVGキャンバスの論理的な座標系の領域。
  • stroke-linecap: round: 線の両端を丸く仕上げるSVGプロパティ。
  • transform-origin: 回転や拡大縮小のときに基準となる中心軸。
  • ハードウェアアクセラレーション(will-change): ブラウザに特定要素のアニメーション演算をGPUへ委ねて滑らかに描画させるヒントを与えるCSSプロパティ。

よくある質問

Q1. なぜ直径から線の太さの半分を引いて半径を求める必要があるのですか?

A1. SVGでは線(Stroke)が仮想のパス(Path)を中心にして左右均等に太くなります。線の太さが10pxなら、中心線の内側に5px、外側に5px広がります。外側に広がった5pxがキャンバスの外に出ないようにするため、円自体の半径を5px小さくして内側に押し込んでいるわけです。

Q2. 円形のパスに沿って複数の色が滑らかにつながるグラデーションは入れられますか?

A2. はい。SVG内で「<defs>」と「<linearGradient>」を使って開始色と終了色を指定し、circleのstrokeプロパティからそのグラデーションIDを参照(「url(#gradient-id)」)させれば実現できます。ただし、円に沿って色が折れ曲がるconic-gradientのような形はSVG 1.1では複雑なので、最新のCSS関数を組み合わせるほうがよいでしょう。

Q3. ゲージがたまる向きと逆(反時計回り、Counter-clockwise)に減っていくようにするにはどうすればいいですか?

A3. ゲージがたまっていく代わりに少しずつ空になっていくようにするには、オフセットの計算式を反転させるか、円を-90度ではなく逆方向に回転させながらオフセットの向きを調整します。いちばん簡単な方法は「transform: scaleX(-1) rotate(-90deg)」のように左右を反転させて逆方向のレンダリングを促すことです。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. clip-pathで図形がゆがむ原因と解決方法clip-pathの%座標は要素の幅と高さに別々に掛かるため、正方形以外の要素では星や多角形がゆがみます。原因の確認方法と、aspect-ratioで正方形に固定するなどの解決手順を紹介します。
  2. 色覚シミュレーターで確認する赤と緑が区別できない理由赤と緑がなぜ同じ色に見えるのかを目の細胞の仕組みから説明し、色だけで情報を伝える問題点と、色覚シミュレーターで配色を点検する方法を紹介します。
  3. WCAGコントラスト比4.5:1の計算式とAA・AAA基準WCAGのコントラスト比4.5:1と3:1がどんな計算から導かれるのか、相対輝度の式とAA・AAAの基準、大きなテキストで基準が緩くなる理由までを解説します。
  4. RGBのユークリッド距離で色の誤差を計算する方法目標色とスライダーで作った色の差を、3次元RGB空間のユークリッド距離で数値化。計算式と正解率の求め方、色合わせのコツを解説します。
  5. カラーパレット生成ツール 色がぶつからない理由ランダムな5色がなぜ調和するのかを、色相環の角度間隔と彩度・明度の範囲から解説。HSL値で自分で確かめる手順も紹介します。
  6. 補色とは?色相環180度でわかる配色の角度と計算方法色相環で補色はちょうど180度反対の色。類似色・トライアド・テトラードが30度・120度・90度に分かれる原理と、HSLの色相角を自分で計算する方法を解説します。

関連ツール