#ドーナツグラフと円グラフ

円グラフとドーナツ グラフは、おそらく最もよく使用されるグラフです。これらはセグメントに分割されており、各セグメントの円弧は各データの比例値を示します。

データ間の関係の比率を示すことに優れています。

円グラフとドーナツ グラフは、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プロパティは、外側の開始コーナーの境界半径を定義します。同様に、outerEndinnerStart、 と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唯一の違いは、cutout0に設定されています。

    #データ構造

    円グラフの場合、データセットにはデータ ポイントの配列が含まれている必要があります。データ ポイントは数値である必要があり、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'
        ]
    };
    
    最終更新: 2023 年 4 月 28 日、午前 5 時 18 分 20 秒