設定

設定は、チャートの動作を変更するために使用されます。スタイル、フォント、凡例などを制御するためのプロパティがあります。

設定オブジェクトの構造

Chart.js設定のトップレベル構造

const config = {
  type: 'line',
  data: {},
  options: {},
  plugins: []
}

タイプ

チャートタイプは、チャートの主要なタイプを決定します。

注記 データセットは `type` をオーバーライドできます。これが複合チャートの構築方法です。

データ

詳細はデータ構造を参照してください。

オプション

ドキュメントの大部分は、これらのオプションについて説明しています。

プラグイン

インラインプラグインはこの配列に含めることができます。これは、単一のチャートにプラグインを追加する別の方法です（プラグインをグローバルに登録するのではなく）。プラグインの詳細については、開発者セクションを参照してください。

グローバル設定

この概念は、Chart.js 1.0 で導入され、設定のDRY (新しいウィンドウで開きます)原則を維持し、チャートタイプ全体でオプションをグローバルに変更できるようにすることで、各インスタンスのオプション、または特定のチャートタイプのデフォルトを指定する必要性を回避します。

Chart.js は、チャートに渡された `options` オブジェクトを、チャートタイプのデフォルトとスケールのデフォルトを適切に使用してグローバル設定とマージします。これにより、個々のチャート設定で必要なだけ具体的に設定できます。適用可能なすべてのチャートタイプのデフォルトを変更することもできます。グローバルな一般オプションは `Chart.defaults` で定義されています。各チャートタイプのデフォルトについては、そのチャートタイプのドキュメントで説明しています。

次の例では、チャートタイプのデフォルトまたは作成時にコンストラクターに渡されたオプションによってオーバーライドされないすべてのチャートのインタラクションモードを「nearest」に設定します。

Chart.defaults.interaction.mode = 'nearest';
// Interaction mode is set to nearest because it was not overridden here
const chartInteractionModeNearest = new Chart(ctx, {
    type: 'line',
    data: data
});
// This chart would have the interaction mode that was passed in
const chartDifferentInteractionMode = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        interaction: {
            // Overrides the global setting
            mode: 'index'
        }
    }
});

データセット設定

オプションは、データセットで直接設定できます。データセットオプションは、複数の異なるレベルで変更できます。オプションの解決方法の詳細については、オプションを参照してください。

次の例では、作成時にデータセットに渡されたオプションによってオーバーライドされるものを除くすべてのラインデータセットの `showLine` オプションを `false` に設定します。

// Do not show lines for all datasets by default
Chart.defaults.datasets.line.showLine = false;
// This chart would show a line only for the third dataset
const chart = new Chart(ctx, {
    type: 'line',
    data: {
        datasets: [{
            data: [0, 0],
        }, {
            data: [0, 1]
        }, {
            data: [1, 0],
            showLine: true // overrides the `line` dataset default
        }, {
            type: 'scatter', // 'line' dataset default does not affect this dataset since it's a 'scatter'
            data: [1, 1]
        }]
    }
});