#極域グラフ
極面グラフは円グラフに似ていますが、各セグメントの角度は同じであり、セグメントの半径は値に応じて異なります。
このタイプのグラフは、円グラフに似た比較データを表示するだけでなく、コンテキストの値のスケールも表示する場合に便利です。
const config = { type: 'polarArea', data: data, options: {} };
#データセットのプロパティ
名前空間:
data.datasets[index]
- このデータセットのみのオプションoptions.datasets.polarArea
- すべてのpolarAreaデータセットのオプション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 |
borderWidth | number | はい | はい | 2 |
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 |
circular | boolean | はい | はい | true |
これらすべての値がundefined
、で説明されているスコープにフォールバックします。オプションの解決策
#全般的
名前 | 説明 |
---|---|
clip | chartArea を基準にしてクリップする方法。正の値ではオーバーフローが許可され、負の値では chartArea 内の多くのピクセルがクリップされます。0 = chartArea でクリップします。クリッピングは側面ごとに構成することもできます。clip: {left: 5, top: false, right: -2, bottom: 0} |
#スタイリング
各円弧のスタイルは、次のプロパティで制御できます。
名前 | 説明 |
---|---|
backgroundColor | 円弧の背景色。 |
borderColor | 円弧の境界線の色。 |
borderDash | 円弧の境界線の長さとダッシュの間隔。見るMDN (新しいウィンドウが開きます)。 |
borderDashOffset | 破線の円弧境界オフセット。見るMDN (新しいウィンドウが開きます)。 |
borderJoinStyle | 円弧の境界線結合スタイル。見るMDN (新しいウィンドウが開きます)。 |
borderWidth | 円弧の境界線の幅 (ピクセル単位)。 |
circular | デフォルトでは、円弧は曲線になっています。もしもcircular: false 弧は平らになります。 |
これらすべての値がundefined
、関連付けられたものへのフォールバックelements.arc.*
オプション。
#境界線の配置
次の値がサポートされていますborderAlign
。
'center'
(デフォルト)'inner'
いつ'center'
を設定すると、隣り合う円弧の境界線が重なり合います。いつ'inner'
が設定されている場合、すべての境界線が重ならないことが保証されます。
#インタラクション
各アークとの相互作用は、次のプロパティで制御できます。
名前 | 説明 |
---|---|
hoverBackgroundColor | ホバー時の円弧の背景色。 |
hoverBorderColor | ホバーしたときの円弧の境界線の色。 |
hoverBorderDash | ホバーしたときの円弧の境界線の長さとダッシュの間隔。見るMDN (新しいウィンドウが開きます)。 |
hoverBorderDashOffset | ホバー時の破線の円弧境界線のオフセット。見るMDN (新しいウィンドウが開きます)。 |
hoverBorderJoinStyle | ホバー時の円弧境界結合スタイル。見るMDN (新しいウィンドウが開きます)。 |
hoverBorderWidth | ホバーしたときの円弧の境界線の幅 (ピクセル単位)。 |
これらすべての値がundefined
、関連付けられたものへのフォールバックelements.arc.*
オプション。
#設定オプション
これらは、極面グラフに固有のカスタマイズ オプションです。これらのオプションはアクセス時に検索され、グローバル チャートのデフォルト オプションチャートのオプション。
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
animation.animateRotate | boolean | true | true の場合、チャートは回転アニメーションでアニメーション化されます。この物件はoptions.animation 物体。 |
animation.animateScale | boolean | true | true の場合、グラフを中心から外側に拡大縮小するアニメーションが表示されます。 |
極面グラフでは、ラジアルリニア規模。追加の構成はスケールを介して提供されます。
#デフォルトのオプション
作成される PolarArea タイプごとにこれらのデフォルト値を変更することもできます。このオブジェクトは次の場所で入手できます。Chart.overrides.polarArea
。グローバル オプションを変更すると、変更後に作成されたグラフにのみ影響します。既存のチャートは変更されません。
たとえば、すべての新しい極面グラフを次のように設定するには、animateScale = false
あなたならこうします:
Chart.overrides.polarArea.animation.animateScale = false;
#データ構造
極面グラフの場合、データセットにはデータ ポイントの配列が含まれている必要があります。データ ポイントは数値である必要があり、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'
]
};