線形軸(linear)
リニア(線形)スケールは、数値データのチャートに使用されます。 名前が示すように、線形補間を使って、値が軸の中心からどの位置にあるかを決定します。
ラジアルリニアスケールでは以下のオプションがあります。
設定オプション
軸には目盛線、アングルライン(レーダーチャートで中心から外側に表示される線)、 pointLabels(レーダーチャートの端に表示されるラベル)のプロパティがあります。 以下のセクションで、それぞれのプロパティを定義します。
名称 | type | 説明 |
---|---|---|
angleLines | object | アングルラインの設定。 詳しくはこちら |
gridLines | object | グリッドラインの設定。 詳しくはこちら |
pointLabels | object | ポイントラベルの設定。 詳しくはこちら |
ticks | object | 目盛線の設定。 詳しくはこちら |
目盛線設定
リニアスケールには、以下のオプションがあります。 これらのオプションは、全てticks
オプションのサブオプションです。 この軸では共通目盛線設定がサポートされています。
名称 | type | 初期値 | 説明 |
---|---|---|---|
backdropColor | color | rgba(255, 255, 255, 0.75) | ラベルの背景色。 |
backdropPaddingX | number | 2 | ラベル背景の水平パディング。 |
backdropPaddingY | number | 2 | ラベル背景の垂直パディング。 |
beginAtZero | boolean | false | true の場合、スケール指定されていなければ0 を表示します。 |
min | number | データの最小値を、スケールの最小値で上書きします。 詳しくはこちら | |
max | number | データの最大値を、スケールの最大値で上書きします。 詳しくはこちら | |
maxTicksLimit | number | 11 | 表示する目盛線とグリッドラインの最大数。 |
precision | number | この値が指定されており、かつstepSize が未指定の場合、 ステップサイズが指定した小数点の桁数に丸められます。 | |
stepSize | number | スケールの固定ステップサイズ。 詳しくはこちら | |
suggestedMax | number | データの最大値を計算する場合に使用する調整値。 詳しくはこちら | |
suggestedMin | number | データの最小値を計算する場合に使用する調整値。 詳しくはこちら | |
showLabelBackdrop | boolean | true | true の場合、ラベル背景を表示します。 |
範囲設定
軸の範囲設定が複数指定された場合に、 それぞれの値が互いにどう作用するか理解することが重要です。
suggestedMax
とsuggestedMin
は、 軸をスケールするために、データのみを変更します。 これらは、自動で軸範囲を変更するに便利です。
let minDataValue = Math.min(mostNegativeValue, options.ticks.suggestedMin);
let maxDataValue = Math.max(mostPositiveValue, options.ticks.suggestedMax);
以下の例では、データの最大値は50
ですが、最大値を100
まで拡張します。 しかし、最小値はsuggestedMin
の値よりも小さいので、無視されます。
let chart = new Chart(ctx, {
type: 'radar',
data: {
datasets: [{
label: 'First dataset',
data: [0, 20, 40, 50]
}],
labels: ['January', 'February', 'March', 'April']
},
options: {
scale: {
ticks: {
suggestedMin: 50
suggestedMax: 100
}
}
}
});
suggested~
とは対象的に、 min
、max
では軸の終端が明示的に設定されます。 これらが設定されると、一部のデータが表示されない場合があります。
ステップサイズ
stepSize
が設定されている場合、 目盛線はstepSize
の倍数で列挙されます。 stepSize
が設定されていない場合、 適切なアルゴリズムを使って自動的に目盛線を表示します。
以下の例では、0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5
に目盛線を生成するY軸チャートを設定しています。
let options = {
scales: {
yAxes: [{
ticks: {
max: 5,
min: 0,
stepSize: 0.5
}
}]
}
};
アングルライン設定
以下のオプションを使って、チャートの中心点から放射状に広がる斜線(アングルライン)を設定します。 これらはangleLine
オプションのサブオプションです。 これらのオプションは、angleLines.display
にture
を指定している場合にのみ適用されることに注意してください。
名称 | type | 初期値 | 説明 |
---|---|---|---|
display | boolean | true | true の場合、アングルラインを表示します。 |
color | color | rgba(0, 0, 0, 0.1) | アングルラインの色。 |
lineWidth | number | 1 | アングルラインの太さ。 |
borderDash | number[] | [] | 線の長さとスペース間隔(ダッシュ構成)。 (MDNを参照してください。) |
borderDashOffset | number | 0.0 | ダッシュのオフセット。 (MDNを参照してください。) |
ポイントラベル設定
以下のオプションは、スケールの周りに表示されるラベル(ポイントラベル)を設定するために使用します。 これらはpointLabels
オプションのサブオプションです。 これらのオプションは、pointLabels.display
にture
を指定している場合にのみ適用されることに注意してください。
名称 | type | 初期値 | 説明 |
---|---|---|---|
display | boolean | true | true を指定した場合、ポイントラベルが表示されます。 |
callback | function | データラベルをポイントラベルに変換するコールバック。 デフォルトは、そのままの文字を返します。 | |
fontColor | color | #666 | ポイントラベルの文字色。 |
fontFamily | string | "'Helvetica Neue', 'Helvetica', 'Arial', sans-serif" | ポイントラベルのフォント。 |
fontSize | number | 10 | ポイントラベルのフォントサイズ。 |
fontStyle | string | normal | ポイントラベルのフォントスタイル。 |
lineHeight | number ,string | 1.2 | 個々のテキスト行の高さ。 (MDNを参照してください。) |
© 2013 Chart.js is available under the MIT license
このコンテンツはChart.jsドキュメントを翻訳/改変したものです。