new CategoryAxis()
CategoryAxis 클래스는 숫자가 아닌 문자가 축의 라벨에 표시되는 카테고리 축을 표현합니다.
일반적으로 차트에서 수치화 할 수는 없지만 그룹화가 가능한 계열의 데이터에 사용됩니다.
예를 들어, 팀명(개발팀, 재무팀, 등)과 같이 수치화는 안되지만 그룹화하여 축의 필드로 사용하고자 할 경우 카테고리 축(CategoryAxis)을 사용합니다.
즉, 데이터 그대로를 출력하고자 할 경우 사용됩니다. 일반적으로 컬럼, 라인 차트 등의 수평 축에 적용됩니다.
축에 설정된 데이터에 동일한 문자열이 존재할 경우, 올바르게 처리되지 않습니다.
레이아웃은 다음과 같은 형식으로 작성됩니다.
<Column2DChart id="chart1" ... >
<horizontalAxis>
<CategoryAxis id="hAxis" categoryField="Month">
</horizontalAxis>
<Column2DChart>
Extends
Members
-
categoryFieldString
-
카테고리 축의 라벨로 표시될 데이터 필드명을 설정합니다.
예를 들어, 수평축(horizontalAxis)에 CategoryAxis를 설정하였다면 X축 라벨은 categoryField 속성에 설정한 데이터가 출력됩니다.- Default Value:
- null
-
formatterObject
-
축의 라벨값을 원하는 숫자(통화) 형식으로 표현하기 위한 포맷터(NumberFormatter, CurrencyFormatter)를 설정합니다.
- Default Value:
- null
-
groupCategoryFieldString
-
그룹 카테고리 라벨을 출력할 경우 카테고리 축의 라벨로 표시될 데이터 필드명 설정합니다.
- Default Value:
- groupCategory
-
idString
-
식별자(Identifier)를 설정합니다.
식별자(Identifier)는 사용자에 의해 정의된 임의의 고유값입니다.
설정된 식별자(Identifier)를 통해 해당 객체에 접근이 가능합니다.- Default Value:
- null
-
labelIntervalNumber
-
축 라벨이 출력될 간격을 설정합니다.
- Default Value:
- 1
-
paddingNumber
-
차트의 데이터가 표시되는 곳의 여백의 크기를 설정합니다.
컬럼, 바 차트 계열의 기본값(default)은 0.5 입니다.
라인, 영역 차트에서 값을 0 으로 설정할 경우, 차트의 데이터가 표시되는 곳의 여백은 없습니다.
여백의 단위는 한 개의 데이터 아이템이 표시되는 공간이 1 입니다.- Default Value:
- 0.5
-
ticksBetweenLabelsBoolean
-
축 라벨을 눈금과 눈금 사이에 표시할 지 눈금과 같은 위치에 표시할 지 여부를 설정합니다.
값을 true 로 설정하면 눈금과 눈금 사이에 라벨이 표시됩니다.- Default Value:
- false
-
titleString
-
축의 제목을 설정합니다.
세로축인 경우 세로로 제목이 출력됩니다.- Default Value:
- null
Methods
-
groupLabelJsFunction(id, value)
-
축의 그룹 라벨을 사용자 정의 라벨로 표현하기 위한 자바스크립트 함수명을 설정합니다.
차트 레이아웃 설정시 groupLabelJsFunction 속성값을 자바스크립트 함수명으로 설정합니다.<horizontalAxis> <CategoryAxis id="hAxis" categoryField="Month" groupLabelJsFunction="axisGroupLabelFunc"> </horizontalAxis> ... axisGroupLabelFunc(id, value) { ... }
Name Type Description id
String 축의 식별자(Identifier)
value
String 축의 라벨값
-
inherited labelJsFunction(id, value, index)
-
축 라벨을 사용자 정의 라벨로 표현하기 위한 자바스크립트 함수명을 설정합니다.
차트 레이아웃 설정시 labelJsFunction 속성값을 자바스크립트 함수명으로 설정합니다.<horizontalAxis> <LinearAxis id="hAxis" labelJsFunction="axisLabelFunc" /> </horizontalAxis> ... function axisLabelFunc(id, value) { return value+"%"; }
Name Type Description id
String 축의 식별자(Identifier)
value
String 축의 라벨값
index
Number 차트 아이템 인덱스