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이 undefined나 null로 지정되면, 축 위치에 따라 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 지점에 표시된다.
[주의]'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를 제공하는 필드.