#ドーナツグラフと円グラフ
円グラフとドーナツ グラフは、おそらく最もよく使用されるグラフです。これらはセグメントに分割されており、各セグメントの円弧は各データの比例値を示します。
データ間の関係の比率を示すことに優れています。
円グラフとドーナツ グラフは、Chart.js では事実上同じクラスですが、デフォルト値が 1 つ異なります。cutout
。これはインナーのどの部分を切り取るかに相当します。これはデフォルトで0
円グラフの場合、および'50%'
ドーナツ用に。
これらは、次の 2 つのエイリアスでも登録されています。Chart
芯。デフォルト値と別名が異なることを除けば、それらはまったく同じです。
#データセットのプロパティ
名前空間:
data.datasets[index]
- このデータセットのみのオプションoptions.datasets.doughnut
- すべてのドーナツ データセットのオプションoptions.datasets.pie
- すべての円グラフ データセットのオプションoptions.elements.arc
- すべてのオプション円弧要素options
- チャート全体のオプション
ドーナツ/円グラフを使用すると、データセットごとに多数のプロパティを指定できます。これらは、特定のデータセットの表示プロパティを設定するために使用されます。たとえば、データセットの円弧の色は通常、このように設定されます。
名前 | タイプ | スクリプト可能 | インデックス可能 | デフォルト |
---|---|---|---|---|
backgroundColor | Color | はい | はい | 'rgba(0, 0, 0, 0.1)' |
borderAlign | 'center' |'inner' | はい | はい | 'center' |
borderColor | Color | はい | はい | '#fff' |
borderDash | number[] | はい | - | [] |
borderDashOffset | number | はい | - | 0.0 |
borderJoinStyle | 'round' |'bevel' |'miter' | はい | はい | undefined |
borderRadius | number |object | はい | はい | 0 |
borderWidth | number | はい | はい | 2 |
circumference | number | - | - | undefined |
clip | number |object |false | - | - | undefined |
data | number[] | - | - | 必要 |
hoverBackgroundColor | Color | はい | はい | undefined |
hoverBorderColor | Color | はい | はい | undefined |
hoverBorderDash | number[] | はい | - | undefined |
hoverBorderDashOffset | number | はい | - | undefined |
hoverBorderJoinStyle | 'round' |'bevel' |'miter' | はい | はい | undefined |
hoverBorderWidth | number | はい | はい | undefined |
hoverOffset | number | はい | はい | 0 |
offset | number |number[] | はい | はい | 0 |
rotation | number | - | - | undefined |
spacing | number | - | - | 0 |
weight | number | - | - | 1 |
これらすべての値がundefined
、で説明されているスコープにフォールバックします。オプションの解決策
#全般的
名前 | 説明 |
---|---|
circumference | アークがカバーするスイープのデータセットごとのオーバーライド |
clip | chartArea を基準にしてクリップする方法。正の値ではオーバーフローが許可され、負の値では chartArea 内の多くのピクセルがクリップされます。0 = chartArea でクリップします。クリッピングは側面ごとに構成することもできます。clip: {left: 5, top: false, right: -2, bottom: 0} |
rotation | 円弧を描画する開始角度のデータセットごとのオーバーライド |
#スタイリング
各円弧のスタイルは、次のプロパティで制御できます。
名前 | 説明 |
---|---|
backgroundColor | 円弧の背景色。 |
borderColor | 円弧の境界線の色。 |
borderDash | 円弧の境界線の長さとダッシュの間隔。見るMDN (新しいウィンドウが開きます)。 |
borderDashOffset | 破線の円弧境界オフセット。見るMDN (新しいウィンドウが開きます)。 |
borderJoinStyle | 円弧の境界線結合スタイル。見るMDN (新しいウィンドウが開きます)。 |
borderWidth | 円弧の境界線の幅 (ピクセル単位)。 |
offset | 円弧のオフセット (ピクセル単位)。 |
spacing | 固定円弧オフセット (ピクセル単位)。に似ているoffset ただし、すべての円弧に適用されます。 |
weight | データセットの相対的な厚さ。重みの値を指定すると、すべてのデータセットの重み値の合計に相対した厚さで円またはドーナツ データセットが描画されます。 |
これらすべての値がundefined
、関連付けられたものへのフォールバックelements.arc.*
オプション。
#境界線の配置
次の値がサポートされていますborderAlign
。
'center'
(デフォルト)'inner'
いつ'center'
を設定すると、隣り合う円弧の境界線が重なり合います。いつ'inner'
が設定されている場合、すべての境界線が重ならないことが保証されます。
#境界半径
この値が数値の場合、円弧のすべてのコーナー (outerStart、outerEnd、innerStart、innerRight) に適用されます。この値がオブジェクトの場合、outerStart
プロパティは、外側の開始コーナーの境界半径を定義します。同様に、outerEnd
、innerStart
、 とinnerEnd
プロパティも指定できます。
#インタラクション
各アークとの相互作用は、次のプロパティで制御できます。
名前 | 説明 |
---|---|
hoverBackgroundColor | ホバー時の円弧の背景色。 |
hoverBorderColor | ホバーしたときの円弧の境界線の色。 |
hoverBorderDash | ホバーしたときの円弧の境界線の長さとダッシュの間隔。見るMDN (新しいウィンドウが開きます)。 |
hoverBorderDashOffset | ホバー時の破線の円弧境界線のオフセット。見るMDN (新しいウィンドウが開きます)。 |
hoverBorderJoinStyle | ホバー時の円弧境界結合スタイル。見るMDN (新しいウィンドウが開きます)。 |
hoverBorderWidth | ホバーしたときの円弧の境界線の幅 (ピクセル単位)。 |
hoverOffset | ホバー時の円弧のオフセット (ピクセル単位)。 |
これらすべての値がundefined
、関連付けられたものへのフォールバックelements.arc.*
オプション。
#設定オプション
これらは、円グラフとドーナツ グラフに固有のカスタマイズ オプションです。これらのオプションはアクセス時に検索され、グローバル チャート設定とともにチャートのオプションを形成します。
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
cutout | number |string | 50% - ドーナツの場合、0 - パイ用 | グラフの中央から切り取られた部分。もしもstring グラフの半径のパーセンテージを示す「%」で終わります。number はピクセルとみなされます。 |
radius | number |string | 100% | チャートの外側の半径。もしもstring 最大半径のパーセンテージを示す「%」で終わります。number はピクセルとみなされます。 |
rotation | number | 0 | 円弧を描く開始角度。 |
circumference | number | 360 | 円弧がカバーできるようにスイープします。 |
animation.animateRotate | boolean | true | true の場合、チャートは回転アニメーションでアニメーション化されます。この物件はoptions.animation 物体。 |
animation.animateScale | boolean | false | true の場合、グラフを中心から外側に拡大縮小するアニメーションが表示されます。 |
#デフォルトのオプション
作成されるドーナツ タイプごとにこれらのデフォルト値を変更することもできます。このオブジェクトは次の場所で入手できます。Chart.overrides.doughnut
。円グラフには、これらのデフォルトのクローンもあり、変更できます。Chart.overrides.pie
唯一の違いは、cutout
0に設定されています。
#データ構造
円グラフの場合、データセットにはデータ ポイントの配列が含まれている必要があります。データ ポイントは数値である必要があり、Chart.js はすべての数値を合計し、それぞれの相対的な割合を計算します。
ツールヒントが正しく表示されるように、ラベルの配列を指定する必要もあります。
data = {
datasets: [{
data: [10, 20, 30]
}],
// These labels appear in the legend and in the tooltips when hovering different arcs
labels: [
'Red',
'Yellow',
'Blue'
]
};