선형 차트
선형 차트는 선 위에 데이터 지점을 구성합니다. 주로, 트렌드 데이터를 보여주거나 두 데이터 집합을 비교할 때 사용됩니다.
사용 예시
var myLineChart = new Chart(ctx, {
type: 'line',
data: data,
options: options
});
데이터집합 속성들
선형 차트는 각 데이터 집합에 대한 특정 속성의 숫자를 지정할 수 있습니다. 특정 데이터 집합에 대한 속성들을 보여주기위한 설정을 하는데 사용됩니다. 예를 들어, 선의 색상을 지정할 때 주로 사용하는 방법입니다.
이름 | 유형 | 스크립트 할 수 있는지 | 인덱스 할 수 있는지 | 기본 값 |
---|---|---|---|---|
backgroundColor |
Color |
Yes | - | 'rgba(0, 0, 0, 0.1)' |
borderCapStyle |
string |
Yes | - | 'butt' |
borderColor |
Color |
Yes | - | 'rgba(0, 0, 0, 0.1)' |
borderDash |
number[] |
Yes | - | [] |
borderDashOffset |
number |
Yes | - | 0.0 |
borderJoinStyle |
string |
Yes | - | 'miter' |
borderWidth |
number |
Yes | - | 3 |
cubicInterpolationMode |
string |
Yes | - | 'default' |
clip |
number|object |
- | - | borderWidth / 2 |
fill |
boolean|string |
Yes | - | true |
hoverBackgroundColor |
Color |
Yes | - | undefined |
hoverBorderCapStyle |
string |
Yes | - | undefined |
hoverBorderColor |
Color |
Yes | - | undefined |
hoverBorderDash |
number[] |
Yes | - | undefined |
hoverBorderDashOffset |
number |
Yes | - | undefined |
hoverBorderJoinStyle |
string |
Yes | - | undefined |
hoverBorderWidth |
number |
Yes | - | undefined |
label |
string |
- | - | '' |
lineTension |
number |
- | - | 0.4 |
order |
number |
- | - | 0 |
pointBackgroundColor |
Color |
Yes | Yes | 'rgba(0, 0, 0, 0.1)' |
pointBorderColor |
Color |
Yes | Yes | 'rgba(0, 0, 0, 0.1)' |
pointBorderWidth |
number |
Yes | Yes | 1 |
pointHitRadius |
number |
Yes | Yes | 1 |
pointHoverBackgroundColor |
Color |
Yes | Yes | undefined |
pointHoverBorderColor |
Color |
Yes | Yes | undefined |
pointHoverBorderWidth |
number |
Yes | Yes | 1 |
pointHoverRadius |
number |
Yes | Yes | 4 |
pointRadius |
number |
Yes | Yes | 3 |
pointRotation |
number |
Yes | Yes | 0 |
pointStyle |
string|Image |
Yes | Yes | 'circle' |
showLine |
boolean |
- | - | undefined |
spanGaps |
boolean |
- | - | undefined |
steppedLine |
boolean|string |
- | - | false |
xAxisID |
string |
- | - | first x axis |
yAxisID |
string |
- | - | first y axis |
주로 사용되는 속성
이름 | 설명 |
---|---|
label |
데이터 집합에 대한 범례와 툴팁을 위한 레이블을 지정합니다. |
order |
데이터 집합이 그려지는 순서를 지정합니다. 또한 쌓이는 순서, 툴팁, 범례에도 영향을 미칩니다. |
xAxisID |
이 데이터 집합을 표시한 x 축의 ID를 지정합니다. |
yAxisID |
이 데이터 집합을 표시한 y 축의 ID를 지정합니다. |
포인트 스타일링
다음의 속성들을 사용하여 각 포인트의 스타일을 제어할 수 있습니다:
이름 | 설명 |
---|---|
pointBackgroundColor |
포인트를 채울 색상을 지정합니다. |
pointBorderColor |
포인트 테두리 색상을 지정합니다. |
pointBorderWidth |
포인트 테두리의 두께를 픽셀단위로 지정합니다. |
pointHitRadius |
마우스 이벤트에 반응하는 표시되지 않는 포인트의 크기에 대한 픽셀을 지정합니다. |
pointRadius |
포인트 모양의 반지름을 지정합니다. 만약 0으로 지정하면, 포인트는 그려지지 않습니다. |
pointRotation |
포인트를 경도에 따라 회전시킵니다. |
pointStyle |
포인트의 스타일을 지정합니다. 더보기... |
이 모든 값들이, 만약 undefined
라면, elements.point.*
옵션과 관련된 데이터 집합의 첫번째 옵션 값으로 지정됩니다.
선 스타일링
다음의 속성들을 사용하여 선의 스타일을 제어할 수 있습니다:
이름 | 설명 |
---|---|
backgroundColor |
선 채우기 색상. |
borderCapStyle |
선의 캡 스타일 지정. MDN 보기. |
borderColor |
선 색상. |
borderDash |
줄표의 길이와 공간 지정. MDN 보기. |
borderDashOffset |
선 줄표에 대한 오프셋 지정. MDN 보기. |
borderJoinStyle |
선 공동 스타일 지정. MDN 보기. |
borderWidth |
선 넓이 지정 (픽셀 단위로). |
clip |
chartArea를 기준으로 자르는 방법을 지정합니다. 양수 값은 오버플로우되며, 음수 값은 chartArea 내에 많은 픽셀들로 잘립니다. 0 = chartArea에 대한 클립. 클리핑은 측면별로 설정할 수도 있습니다: clip: {left: 5, top: false, right: -2, bottom: 0} |
fill |
선 아래 영역을 어떻게 채울지 지정합니다. area charts 보기. |
lineTension |
선의 베지어 곡선 장력을 지정. 0으로 설정하면 직선으로 그립니다. 이 옵션은 모노톤 큐빅 삽입기능을 사용하면 무시됩니다. |
showLine |
false이면, 이 데이터집합에 대한 선은 그려지지 않습니다. |
spanGaps |
true이면, 데이터가 없거나 null인 점 사이에 선이 그려집니다. false이면, NaN 데이터가 있는 포인트가 줄에 끊김을 생성합니다. |
만약 값이 undefined
이면, showLine
과 spanGaps
는 관련 차트 설정 옵션으로 대체됩니다. 나머지 값들은 관련 elements.line.*
옵션으로 대체됩니다.
상호작용
각 포인트의 상호작용은 다음의 속성들로 제어할 수 있습니다:
이름 | 설명 |
---|---|
pointHoverBackgroundColor |
호버했을 때 포인트의 바탕 색상을 지정합니다. |
pointHoverBorderColor |
호버했을 때 포인트 테두리 색상을 지정합니다. |
pointHoverBorderWidth |
호버했을 때 포인트의 테두리 넓이를 지정합니다. |
pointHoverRadius |
호버했을 때 포인트의 반지름을 지정합니다. |
cubicInterpolationMode
다음의 삽입 모드를 지원합니다.
'default'
'monotone'
'default'
알고리즘은 데이터집합의 모든 유형에 대한 쾌적한 곡선을 생성하는 사용자 지정 가중치 큐빅 삽입법을 사용합니다.
'monotone'
알고리즘은 y = f(x)
데이터집합에 더 적합합니다 : 삽입되는 데이터 집합의 단조성(또는 부분적 단조성)을 보존하며, 로컬의 극한 값이(있는 경우) 입력 데이터 포인트에 유지되도록 합니다.
만약에 값을 그대로 두면 (undefined
), 전역 속성인 options.elements.line.cubicInterpolationMode
를 사용합니다.
Stepped Line
다음의 값을은 steppedLine
에 지원됩니다.
false
: 단계 삽입 없음 (기본 값)true
: Step-before 삽입 (eq.'before'
)'before'
: Step-before 삽입'after'
: Step-after 삽입'middle'
: Step-middle 삽입
만약 steppedLine
값이 false 이외의 값으로 설정된다면, lineTension
은 무시됩니다.
설정 옵션
선형 차트 정의는 다음의 설정 옵션이 있습니다. 이 옵션들은 차트를 형성하기 위해 전달된 옵션인 전역 차트 설정 옵션 Chart.defaults.global
과 합쳐집니다.
이름 | 유형 | 기본 값 | 설명 |
---|---|---|---|
showLines |
boolean |
true |
false이면, 포인트 사이의 선이 그려지지 않습니다. |
spanGaps |
boolean |
false |
false이면, NaN 데이터로 인해 선이 끊깁니다. |
기본 옵션
모든 생성된 선형 차트에 적용되는 일반적인 설정입니다. 전역 선형 차트 설정은 Chart.defaults.line
에 저장되어 있습니다. 전역 옵션을 바꾸면 바꾼 이후에 생성된 차트에 대해서만 적용됩니다. 이미 존재하던 차트들은 바뀌지 않습니다.
예를 들어, 모든 선형 차트의 설정을 spanGaps = true
로 할려면:
Chart.defaults.line.spanGaps = true;
데이터 구조
선형 차트에 대한 데이터집합의 data
속성은 2가지 형식이 있습니다.
number[]
data: [20, 10]
data
배열이 숫자들의 배열일 때 x축은 일반적으로 카테고리 입니다. 포인트는 배열의 위치에 따라 축에 자리합니다. 카테고리 축으로 선형 차트가 생성될 때, 데이터 객체의 labels
속성은 반드시 설정해야 합니다.
Point[]
data: [{
x: 10,
y: 20
}, {
x: 15,
y: 10
}]
이 대체 유형은 최소 데이터집합에 사용됩니다, 도표형 차트와 같은 곳에요. 각 데이터 포인트는 객체에 있는 x
와 y
속성들을 사용하여 특정됩니다.
누적 영역 차트
선형 차트는 y축에 누적을 허용한 변경 설정을 통해 누적 영역 차트를 설정할 수 있습니다. 누적 영역 차트는 한 데이터의 트렌드가 작은 조각들의 숫자들로 만들어졌는지 보여주는데 사용할 수 있습니다..
var stackedLine = new Chart(ctx, {
type: 'line',
data: data,
options: {
scales: {
yAxes: [{
stacked: true
}]
}
}
});