CategoryAxisOptions extends AxisOptions

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

Options

animatable: boolean (opens in a new tab)

default :true

categories: Array (opens in a new tab)<string (opens in a new tab) | object (opens in a new tab)>

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

default :undefined

categoryField: string (opens in a new tab) | number (opens in a new tab)

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

default :undefined

categoryPadding: number (opens in a new tab)

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

default :0.1

categorySeries: string (opens in a new tab)

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

default :undefined

col: number (opens in a new tab)

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

default :0

crosshair: boolean (opens in a new tab) | CrosshairOptions

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

default :undefined

fixedSize: boolean (opens in a new tab)

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

default :false

grid: boolean (opens in a new tab) | AxisGridOptions

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

default :undefined

guide: Array (opens in a new tab)<AxisGuideOptions>

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

default :undefined

label: boolean (opens in a new tab) | AxisLabelOptions

default :undefined

line: string (opens in a new tab) | boolean (opens in a new tab) | AxisLineOptions

default :undefined

marginFar: number (opens in a new tab)

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

default :0

marginNear: number (opens in a new tab)

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

default :0

maxPadding: number (opens in a new tab)

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

default :undefined

maxValue: number (opens in a new tab)

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

default :undefined

minPadding: number (opens in a new tab)

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

default :undefined

minValue: number (opens in a new tab)

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

default :undefined

name: string (opens in a new tab)

default :undefined

padding: number (opens in a new tab)

축의 양 끝 카테고리 위치 전후에 여백으로 추가되는 크기.
각각 시작/끝 카테고리에 대한 상대적 크기로 지정한다. 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 (opens in a new tab)

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

default :false

row: number (opens in a new tab)

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

default :0

scrollBar: boolean (opens in a new tab) | AxisScrollBarOptions

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

default :undefined

sectorLine: boolean (opens in a new tab) | AxisSectorLineOptions

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

default :undefined

startAngle: number (opens in a new tab)

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

default :0

startOffset: number (opens in a new tab)

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

default :0

style: SVGStyles | string (opens in a new tab)

스타일셋 혹은 class selector.

default :undefined

tick: boolean (opens in a new tab) | AxisTickOptions

default :undefined

title: string (opens in a new tab) | AxisTitleOptions

default :undefined

tooltipFooter: string (opens in a new tab)

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

default :undefined

tooltipHeader: string (opens in a new tab)

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

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

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

tooltipRow: string (opens in a new tab)

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

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

totalAngle: number (opens in a new tab)

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

default :360

type: 'category'

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

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

축으로 자동 설정된다.

default :undefined

unit: string (opens in a new tab)

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

default :undefined

visible: boolean (opens in a new tab)

표시 여부.

default :true

weightSeries: string (opens in a new tab)

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

default :undefined

wieghtField: string (opens in a new tab) | number (opens in a new tab)

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

default :undefined