Chart.js - にほんご。

Elements

更新日: 2019-12-06

チャートタイプは各データセット毎にスタイルの設定が可能ですが、 時には全てのデータセットで共通のスタイルを指定したい場合があります。 よくある例は、棒グラフの全ての棒を同じ色のストローク(枠線)で生成し、 塗りつぶしを各データ毎に変更するといったことです。 オプションとして arclinepointrectangle の4つの要素を設定することができます。 これらのオプションを設定すると、データセット毎の設定が指定されていない限り、 全てのオブジェクトに適用されます。

グローバル設定

elementオプションは、チャート毎か、グローバルに指定することができます。 グローバルオプションはChart.defaults.global.elementsで定義されています。 例えば、グローバルに全ての棒グラフのボーダー幅を設定する場合、以下のように指定します。

Chart.defaults.global.elements.rectangle.borderWidth = 2;

point

point要素は、折れ線グラフ(LineChart)やバブルチャート(BubbleChart)の"点"を表すために使用します。

グローバルオプションはChart.defaults.global.elements.pointで定義されています。

名称type初期値説明
radiusnumber3ポイントの半径。
pointStylestring, imagecircleポイントのスタイル。
rotationnumber0ポイントの角度(単位:度)。
backgroundColorcolorrgba(0,0,0,0.1)ポイントの色。
borderWidthnumber1ポイントの枠線の幅。
borderColorcolorrgba(0,0,0,0.1)ポイントの枠線の色。
hitRadiusnumber1ホバー検出の為の追加半径。
hoverRadiusnumber4ホバーした時のポイントの半径。
hoverBorderWidthnumber1ホバーした時の線の幅。

pointスタイル

以下のスタイルを指定することができます。

  • circle
  • cross
  • crossRot
  • dash
  • line
  • rect
  • rectRounded
  • rectRot
  • star
  • triangle

値が画像の場合、drawImageを使ってキャンバスに表示します。

line

line要素は線グラフ(LineChart)の"線"を表すために使用します。

グローバルオプションはChart.defaults.global.elements.lineで定義されています。

名称type初期値説明
tensionnumber0.4ベジェ曲線のテンション(張力)。(0の場合は非曲線になります。)
backgroundColorcolorrgba(0,0,0,0.1)線の塗りつぶしの色。
borderWidthnumber3線の太さ。
borderColorcolorrgba(0,0,0,0.1)線の色。
borderCapStylestringbutt線の先端のスタイル。 (MDNを参照してください。)
borderDashnumber[][]線のダッシュ構成。 (MDNを参照してください。)
borderDashOffsetnumber0ダッシュのオフセット。 (MDNを参照してください。)
borderJoinStylestringmiter線の接合点のスタイル。 (MDNを参照してください。).
capBezierPointsbooleantruetrueの場合、ベジェコントロールの位置をチャートのキャンバス内に制限します。 制限しない場合はfalseを指定します。
cubicInterpolationModestringdefalt適用する補間モードを設定します。 詳細はこちら
fillboolean, stringtrue塗りつぶし場所を指定します。文字列:startendoriginまたは、 真偽値:true(startと同等)、false(塗りつぶさない)。
steppedbooleanfalsetrueの場合、ステップライングラフを表示します。 (tensionは無視されます。)

デモ1

ポイントの指定と、線のスタイルを指定しています。

JavaScript
var ctx = document.getElementById('myChart').getContext('2d');
Chart.defaults.global.elements.point = {
    radius: 5,              // ポイントの半径
    pointStyle: 'triangle', // ポイントのスタイル
    hitRadius: 20,          // ホバー検出の半径
    hoverRadius: 20,        // ホバー時の半径
};
Chart.defaults.global.elements.line = {
    tension: 0,       // 折れ線グラフ
    fill: 'end',      // 上側を塗りつぶす
    borderDash: [],   // ダッシュ線設定(.lineを指定する場合必要な模様)
};
new Chart(ctx, {
    type: 'line',
    data: {
        labels: ["January", "February", "March", "April", "May", "June", "July"],
        datasets:[{
            type: 'line',
            label: "A",
            data: [65, 59, 80, 81, 56, 55, 40],
            backgroundColor: "rgba(54, 162, 235, 0.2)",
            borderColor: "rgb(54, 162, 235)",
            borderWidth: 1
        },
        {
            type: 'line',
            label: "B",
            data: [55, 59, 70, 91, 26, 25, 70],
            backgroundColor: "rgba(255, 99, 132, 0.2)",
            borderColor: "rgb(255, 99, 132)",
            borderWidth: 1,
        }]
    },
});
HTML
<canvas id="myChart"></canvas>

rectangle

rectangle要素は棒グラフ(BarChart)の"棒"を表すために使用します。

グローバルオプションはChart.defaults.global.elements.rectangleで定義されています。

名称type初期値説明
backgroundColorcolorrgba(0,0,0,0.1)棒グラフを塗りつぶす色。
borderWidthnumber0棒グラフの線の太さ。
borderColorcolorrgba(0,0,0,0.1)棒グラフの線の色。
borderSkippedstringbottom枠線の除外設定。 bottomlefttoprightを指定します。

デモ2

棒のスタイルを指定しています。

JavaScript
var ctx = document.getElementById('myChart').getContext('2d');
Chart.defaults.global.elements.rectangle = {
    borderWidth: 5,       // 枠線の太さ
    borderSkipped: 'top'  // 上部の枠線の除外
};
new Chart(ctx, {
    type: 'bar',
    data: {
        labels: ["Red", "Blue", "Yellow", "Green", "Purple", "Orange"],
        datasets: [{
            label: '# of Votes',
            data: [12, 19, 3, 5, 2, 3],
            backgroundColor: [
                'rgba(255, 99, 132, 0.2)',
                'rgba(54, 162, 235, 0.2)',
                'rgba(255, 206, 86, 0.2)',
                'rgba(75, 192, 192, 0.2)',
                'rgba(153, 102, 255, 0.2)',
                'rgba(255, 159, 64, 0.2)'
            ],
            borderColor: [
                'rgba(255,99,132,1)',
                'rgba(54, 162, 235, 1)',
                'rgba(255, 206, 86, 1)',
                'rgba(75, 192, 192, 1)',
                'rgba(153, 102, 255, 1)',
                'rgba(255, 159, 64, 1)'
            ],
        }]
    },
    options: {
        scales: {
            yAxes: [{
                ticks: {
                    beginAtZero:true
                }
            }]
        },
    }
});
HTML
<canvas id="myChart"></canvas>

arc

arc要素は鶏頭図(PolarAreaChart)、ドーナツグラフ(DoughnutChart)、円グラフ(PieChart)での"弧"のスタイルに使用されます。

グローバルオプションはChart.defaults.global.elements.arcで定義されています。

名称type初期値説明
angle(鶏頭図のみ)number円周/弧の数弧の角度。
backgroundColorcolorrgba(0,0,0,0.1)弧を塗りつぶす色。
borderAlignstrigncenter弧の枠線の位置。
borderColorcolor#fff弧の枠線の色。
borderWidthnumber2弧の枠線の太さ。

デモ3

孤のスタイルを指定しています。

JavaScript
var ctx = document.getElementById('myChart').getContext('2d');
Chart.defaults.global.elements.arc = {
    borderWidth: 5,       // 枠線の太さ
};
new Chart(ctx, {
    type: 'bar',
    data: {
        labels: ["Blue", "Red", "Yellow"],
        datasets:[{
            data: [65, 59, 80],
            backgroundColor: [
                "rgb(54, 162, 235)",
                "rgb(255, 99, 132)",
                "rgb(255, 206, 86)",
            ],
        }]
    },
});
HTML
<canvas id="myChart"></canvas>


© 2013 Chart.js is available under the MIT license

このコンテンツはChart.jsドキュメントを翻訳/改変したものです。