CategoryAxisOptions extends AxisOptions

지정된 카테고리 개수로 축을 분할해서 각 카테고리에 연결된 데이터포인트들이 표시되게 한다.
카테고리 하나가 1의 축 값(너비)을 갖는다. 주로 x축으로 사용되며, 선형(linear)축과 달리 축을 분할한 각 카테고리는 서로 격리되어 있으며, 기본적으로 개별 카테고리의 너비(간격)나 카테고리들 사이의 순서는 의미가 없다. 즉, 카테고리가 위치한 축 값(숫자)이 data로서는 별 의미가 없는 경우에 사용한다. 축 상에 데이터포인트가 존재하지 않는 영역이 존재하게 된다면 선형 축을 고려해야 한다. (데이터포인트가 없는 영역을 자동으로 없애지는 않는다.)
반대로, 선형(linear, time, log) 축들은 축 값이 의미있는 data이므로, 축 값은 연속되고 데이터포인트가 없는 영역 또한 그 자체로 의미가 있다.
또, 축 label에 카테고리를 대표하는 이름을 표시할 필요한 경우 먼저 카테고리 축을 고려해야 한다.
categories가 명시적으로 지정되지 않은 경우, 연결된 시리즈의 데이터포인트들의 'x' 값들 중 문자열인 것들을 모아 순서대로 구성하는데, 이렇게 지정하는 경우 중복되지 않도록 빠짐없이 설정해야 한다. 또는, categorySeries와 categoryField를 지정해서 카테고리로 사용할 목록을 수집할 수도 있다.
중복없는 문자열 배열로 카테고리 목록이 구성되므로 시리즈의 data 항목 순서와 불일치한 상태로 표시된다. 문자열이 설정되지 않은 데이터포인트의 xValue값은 숫자값이 아니면 xStart와 xStep을 기준으로 순서대로 설정된다.

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) | Array (opens in a new tab)<string (opens in a new tab) | number (opens in a new tab)>

카테고리로 사용되는 dataPoint 속성.
각 데이터포인트의 이 속성 값 중 문자열값들이 연결된 카테고리 축의 category 목록으로 사용된다. field가 둘 이상일때는 마지막 필드 값이 문자열이어야 한다. 또, x 값 대신 이 속성 값에 해당하는 categroy 값이 데이터포인트의 x값이 된다.
축 tick에는 마지막 필드로 지정된 문자열이 표시된다.
categories가 지정되면 이 속성은 무시된다.

default :undefined

categoryPadding: number (opens in a new tab)

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

default :0.1

categorySeparator: string (opens in a new tab)

categoryField가 배열일 경우, 마지막 필드 값을 구분하기 위해 사용하는 내부 구분 자이다. 데이터값에 없는 문자열로 지정해야 라벨이 올바르게 표시된다.

default :'+'

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 형태로 축 위의 마우스 위치를 표시하는 옵션.
boolean (opens in a new tab) 값으로 지정하면 visible 속성을 지정한 것과 동일하다.

default :undefined

fixedSize: boolean (opens in a new tab)

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

default :false

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

visible 기본값이 undefined이다.
boolean (opens in a new tab) 값으로 지정하면 visible 속성을 지정한 것과 동일하다. 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) | CategoryAxisLabelOptions

default :undefined

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

축 선 설정 옵션.
boolean (opens in a new tab) 값으로 지정하면 visible 속성을, 문자열로 지정하면 style.stroke를 지정한 것과 동일하다.

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) | Array (opens in a new tab)<\[ | number (opens in a new tab) | 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) | Array (opens in a new tab)<\[ | number (opens in a new tab) | 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)

축 이름.
이름을 지정하지 않으면 '-axis-{index + 1}' 형식으로 자동 지정된다. 즉, 첫번째 축이면 '-axis-1'이 된다.

default :undefined

padding: number (opens in a new tab) | Array (opens in a new tab)<\[ | number (opens in a new tab) | number (opens in a new tab) | ]>

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

default :0

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

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

• 'auto' 상대 축에 따라 위치를 조정한다.
  x축이 reversed이면 y축이 반대 쪽에 표시되고, y축이 reversed이면 x축이 반대 쪽에 표시된다.
• 'between' split 모드일 때, 중간 분할 위치에 표시한다.
  마자믹 pane이 아니면 'opposite'와 동일하고, 마지막 pane이면 'normal'과 동일하다.
• '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된 x축에 표시할 수 있는 스크롤바 옵션.
boolean (opens in a new tab) 값으로 지정하면 visible 속성을 지정한 것과 동일하다.
y축은 scrollBar가 표시되지 않는다.

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)

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

default :undefined

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

default :undefined

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

축 title 설정 옵션.
문자열로 지정하면 타이틀의 visible 속성을 지정한 것과 동일하다.

default :undefined

totalAngle: number (opens in a new tab)

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

default :360

type: 'category'

default :undefined

unit: string (opens in a new tab)

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

default :undefined

unitLabel: string (opens in a new tab) | boolean (opens in a new tab) | AxisUnitLabelOptions

단위 label 설정 옵션.

default :undefined

visible: boolean (opens in a new tab)

값을 지정하지 않으면 연결된 시리즈가 있는 경우에 표시된다.
명시적 boolean (opens in a new tab)값을 지정하면 그 설정에 따라 표시 여부가 결정된다. 또, 표시 여부와 상관없이, 이 축에 연결된 시리즈들은 이 축의 범위에 맞게 표시된다.

default :undefined

weightByFrequency: boolean (opens in a new tab)

시리즈 x값들로 부터 카테고리를 구성할 때, 연속된 동일 x값의 개수로 weight로 설정한다.

default :undefined

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

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

default :undefined

weightSeries: string (opens in a new tab)

weightField와 함께 각 카테고리의 weight제공하는 시리즈.
이 속성에 해당하는 시리즈가 없는 경우 categorySeries로 지정된 시리즈를 참조한다. 설정된 category 목록과 순서가 일치하도록 설정해야 한다.

default :undefined