Class: CategoryAxis

CategoryAxis

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

차트 아이템 인덱스