Config
category

xAxis[type=category]

지정된 카테고리 개수로 축을 분할해서 각 카테고리에 연결된 데이터포인트들이 표시되게 한다.
카테고리 하나가 1의 축 값(너비)을 갖는다. 주로 x축으로 사용되며, 선형(linear)축과 달리 축을 분할한 각 카테고리는 서로 격리되어 있으며, 기본적으로 개별 카테고리의 너비(간격)나 카테고리들 사이의 순서는 의미가 없다. 즉, 카테고리가 위치한 축 값(숫자)이 data로서는 별 의미가 없는 경우에 사용한다. 축 상에 데이터포인트가 존재하지 않는 영역이 존재하게 된다면 선형 축을 고려해야 한다. (데이터포인트가 없은 영역을 자동으로 없애지는 않는다.)
반대로, 선형(linear, time, log) 축들은 축 값이 의미있는 data이므로, 축 값은 연속되고 데이터포인트가 없는 영역 또한 그 자체로 의미가 있다.
또, 축 label에 카테고리를 대표하는 이름을 표시할 필요한 경우 먼저 카테고리 축을 고려해야 한다.

Options

animatable: boolean

default :true

categories: (string|object)[]

명시적으로 지정하는 카테고리 목록.
문자열로 카테고리 항목을 지정하거나, object로 지정할 때에는 name(혹은 label) 속성에 카테고리 이름을 문자열로, width 속성에 상대 너비(1이 기본 너비)를 숫자로 지정한다. 첫 번째 값이 startValue에 해당하고 valueStep씩 증가한다. 각 카테고리의 상대적 너비를 지정할 수 있다.
이 목록을 지정하지 않으면 축에 연결된 시리즈들로부터 카테고리 목록을 자동 생성한다. 하지만 시리즈들이 모두 사라지는 경우 카테고리 목록 역시 사라지므로, 기대하는 카테고리 목록을 고정 표시하려는 경우 이 목록을 설정하는 것이 좋다.

categoryField: string|number

카테고리로 사용되는 dataPoint 속성.
categories가 지정되면 이 속성은 무시된다.

categoryPadding: number

각 카테고리의 양 끝에 추가되는 여백의 카테고리에 너비에 대한 상대적 크기.
0 ~ 0.5 사이의 값으로 지정한다.

default :0.1

categorySeries: string

Category 목록을 수집하는 시리즈.
지정하지 않으면 모든 시리즈에서 카테고리를 수집한다.

col: number

분할 모드일 때 축이 표시될 pane의 수평 위치.

default :0

crosshair

직선 또는 bar 형태로 축 위의 마우스 위치를 표시하는 옵션.

fixedSize: boolean

true로 지정하면 새로 계산된 너비나 높이가 이전 계산된 크기보다 작으면 이전 크기를 유지한다.

default :false

grid

visible 기본값이 undefined이다.
visible이 undefinednull로 지정되면, 축 위치에 따라 visible 여부가 결정된다.

guide

가이드 옵션.
옵션 객체 또는 옵션 객체 배열로 여러 가이드를 설정할 수 있다.
[주의] 이전 버전의 설정을 로드하기 위해, 이 속성이 지정되지 않고 'guides' 설정이 존재하면 load 후 이 속성으로 설정한다.

label

line

marginFar: number

차트 경계나 뒤쪽 축 사이의 여백 크기.

default :0

marginNear: number

plot 영역이나 먼저 표시되는 축 사이의 여백 크기.

default :0

maxPadding: number

축의 끝 카테고리 위치 이 후에 여백으로 추가되는 크기.
카테고리 기본 너비(1)에 대한 상대적 크기로 지정한다. padding 속성으로 양끝 padding을 한꺼번에 지정할 수 있다.

maxValue: number

명시적으로 지정하는 최대값.

minPadding: number

축의 시작 카테고리 위치 이 전에 여백으로 추가되는 크기.
카테고리 기본 너비(1)에 대한 상대적 크기로 지정한다. padding 속성으로 양끝 padding을 한꺼번에 지정할 수 있다.

minValue: number

명시적으로 지정하는 최소값.

name: string

padding: number

축의 양 끝 카테고리 위치 전후에 여백으로 추가되는 크기.
각각 시작/끝 카테고리에 대한 상대적 크기로 지정한다. minPadding, maxPadding으로 별도 지정할 수 있다.

default :0

position: 'auto'|'base'|'between'|'normal'|'opposite'

표시 위치. 기본적으로 상대 축의 원점 쪽에 표시된다.

  • 'auto' 상대 축에 따라 위치를 조정한다.
    x축이 reversed이면 y축이 반대 쪽에 표시되고, y축이 reversed이면 x축이 반대 쪽에 표시된다.
  • 'base' 상대 축의 baseValue 지점에 표시된다.
    [주의]
    1. 축에 연결된 시리즈들이 BarSeries 계열일 때만 가능하다.
    2. 차트의 X축 하나에만 적용할 수 있다. 두번째로 지정된 축의 속성은 NORMAL로 적용된다.
    3. 상대 축이 linear 가 아니거나 baseValue가 min 보다 작거나 max보다 크면 이 값은 무시되고, NORMAL로 적용된다.
  • 'between' Y축이고, 축이 연결되는 body가 분할 상태일 때, 중간 분할 위치에 표시한다.
  • 'normal' X축은 아래쪽에 수평으로, Y축은 왼쪽에 수직으로 표시된다.
    inverted이면 Y축이 아래쪽에 수평으로, X축은 왼쪽에 수직으로 표시된다.
  • 'opposite' X축은 위쪽에 수평으로, Y축은 오른쪽에 수직으로 표시된다.
    inverted이면 Y축이 위쪽에 수평으로, X축은 오른쪽에 수직으로 표시된다.

default :'normal'

reversed: boolean

true면 반대 방향으로 point 위치들이 지정된다.

default :false

row: number

분할 모드일 때 축이 표시될 pane의 수직 위치.

default :0

scrollBar

zoom된 축에 표시할 수 있는 스크롤바 옵션.

sectorLine

부채꼴 polar 좌표계의 X 축일 때 원호의 양 끝과 중심에 연결되는 선분들의 설정모델.
startAngle, totalAngle을 참조한다.

startAngle: number

Polar 차트에서 사용될 때 시작 각도.

default :0

startOffset: number

polar 축일 때 시작 위치 간격.
첫번째 카테고리 너비(각도)에 대한 상대값으로 0~1 사이의 값을 지정한다. ex) 0.5로 지정하면 bar 시리즈의 첫 째 bar가 12시 위치에 표시된다.

default :0

style: SVGStyles|string

스타일셋 또는 css selector (opens in a new tab).

tick

title

tooltipFooter: string

축에 포함된 시리즈들 툴팁의 아래쪽에 표시되는 텍스트 템플릿.

tooltipHeader: string

축에 포함된 시리즈들 툴팁의 위쪽에 표시되는 텍스트 템플릿.

tooltipHeader tooltipRow, tooltipRow, ... tooltipFooter 형태로 툴팁이 표시된다.

default :'<b>${name}</b>'

tooltipRow: string

축에 포함된 각 시리즈별 표시되는 포인트 툴팁 텍스트 템플릿.

default :'${series}:<b>${yValue}</b>'

totalAngle: number

Polar 차트에서 사용될 때 원호 전체 각도.
0 ~ 360 사이의 값으로 지정해야 한다. 범위를 벗어난 값은 범위 안으로 조정된다. 지정하지 않거나 잘못된 값이면 360으로 계산된다.

default :360

type: 'category'

축 종류를 지정한다.
이 속성값이 지정되지 않은 경우,

  • categories가 설정되면 'category'
  • x축이고 첫번째 시리즈가 category축에 연결 가능할 때 'category', 아니면 'linear'
  • y축이면 첫번째 시리즈의 기본 y축 타입(대부분 'linear'), 아니면 'linear'

축으로 자동 설정된다.

unit: string

label 등에 표시할 수 있는 단위 정보 문자열.

visible: boolean

표시 여부.

default :true

weightSeries: string

weigth 필드를 제공하는 시리즈.

wieghtField: string|number

weightSeries data에서 weight를 제공하는 필드.