선형 차트

선형 차트는 선 위에 데이터 지점을 구성합니다. 주로, 트렌드 데이터를 보여주거나 두 데이터 집합을 비교할 때 사용됩니다.

사용 예시

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 이면, showLinespanGaps 는 관련 차트 설정 옵션으로 대체됩니다. 나머지 값들은 관련 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
}]

이 대체 유형은 최소 데이터집합에 사용됩니다, 도표형 차트와 같은 곳에요. 각 데이터 포인트는 객체에 있는 xy 속성들을 사용하여 특정됩니다.

누적 영역 차트

선형 차트는 y축에 누적을 허용한 변경 설정을 통해 누적 영역 차트를 설정할 수 있습니다. 누적 영역 차트는 한 데이터의 트렌드가 작은 조각들의 숫자들로 만들어졌는지 보여주는데 사용할 수 있습니다..

var stackedLine = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        scales: {
            yAxes: [{
                stacked: true
            }]
        }
    }
});

results matching ""

    No results matching ""