Class: Axis2DRenderer

Axis2DRenderer

new Axis2DRenderer()

Axis2DRenderer 클래스는 차트의 종류가 2D 인 경우, 축의 렌더링에 사용됩니다.

축의 굵기, 축의 색, 눈금의 위치, 눈금의 색 등을 조절할 수 있습니다.

반드시 axis 속성에 표현하고자 하는 축의 식별자(Identifier)를 설정해야 합니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

<Axis2DRenderer axis="{vAxis}" tickLength="20" minorTickLength="0" tickPlacement="outside" placement="left" canDropLabels="false" showLabels="true">
  <axisStroke>
    <Stroke weight="10" color="0x66CCFF">
  </axisStroke>
  <tickStroke>
    <Stroke weight="2" color="0xFF0000" />
  </tickStroke>
  <minorTickStroke>
    <Stroke weight="1" color="0x0000FF" caps="square" />
  </minorTickStroke>
</Axis2DRenderer>

Members

autoLineBreakBoolean

라벨의 길이가 lineBreakWidth 속성에 설정된 값 이상일 경우 자동으로 줄 바꿈할 지 여부를 설정합니다.

Default Value:
  • false

axisObject

표현하고자 하는 축을 설정합니다.

이 값에는 horizontalAxis 또는 verticalAxis 에 할당된 축의 식별자(Identifier)를 설정하십시오.

Default Value:
  • null

axisStrokeObject

축을 표시하는 선의 속성을 설정합니다.

유효값은 Stroke 클래스의 인스턴스입니다.

Default Value:
  • Stroke("#f1f1f1", 1, 1)

axisTitleStyleNameString

축 타이틀의 스타일을 <Style> 노드에 설정할 경우, <Style> 노드에 정의된 이름을 설정합니다.

<Style> 노드에 스타일을 정의할 때는 반드시 스타일명 앞에 마침표가 위치해야 합니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

<verticalAxisRenderers>
  <Axis2DRenderer axis="{vAxis}" axisTitleStyleName="vStyle" ... />'
</verticalAxisRenderers>'
...
<Style>
  .vStyle{color:#ffffff;fontSize:12;}
</Style>
Default Value:
  • null

canDropLabelsBoolean

축의 라벨들을 겹치지 않게 표시하기 위해 필요에 따라서 라벨들을 삭제할 지 여부를 설정합니다.

이 속성값이 설정되지 않으면, 렌더링하는 축의 유형에 따라서 적절한 값이 기본값(default)으로 설정됩니다.

유효값은 다음과 같습니다.


  • true

    • 렌더링 시 겹치는 라벨들을 삭제합니다.

    • 라벨들은 항상 일정한 간격으로 표시되며 필요한 경우 2 개 또는 3 개의 라벨을 표시하지 않고 다음 라벨을 표시합니다.

    • 연속으로 삭제되는 라벨의 개수는 동일합니다. 예를 들어, 2 개의 라벨이 삭제되었다가 다음에는 3 개의 라벨이 삭제되지는 않습니다.



  • false

    • 라벨이 겹치는 경우, Axis2DRenderer 클래스 인스턴스는 회전, 확대/축소를 사용해 라벨을 표시합니다. (내장 폰트 사용시)



Default Value:
  • true

canStaggerBoolean

축 라벨을 위, 아래 교대로 표시할 지 여부를 설정합니다.

이 설정을 사용해 라벨이 차지하는 영역의 자리를 최소화 할 수 있습니다.

기본값(default)은 false 이며 위, 아래 교대로 표시합니다.

Default Value:
  • false

dropLabelOffsetNumber

라벨이 겹치는지 여부를 판단하는 기준이 되는 라벨과 라벨 사이의 간격을 설정합니다.

라벨과 라벨 사이의 간격이 설정된 값과 같거나 작으면 차트 시스템은 두 라벨이 겹치는 것으로 판단합니다.

Default Value:
  • 4

formatterObject

축의 라벨값을 원하는 숫자(통화) 형식으로 표현하기 위한 포맷터(NumberFormatter, CurrencyFormatter)를 설정합니다.

Default Value:
  • null

groupLabelGapNumber

그룹 라벨들 간의 여백의 크기를 설정합니다.

Default Value:
  • 5

groupLabelStrokeObject

그룹 라벨 선의 속성을 설정합니다.

유효값은 Stroke 클래스의 인스턴스입니다.

Default Value:
  • Stroke("#777777");

idString

식별자(Identifier)를 설정합니다.

식별자(Identifier)는 사용자에 의해 정의된 임의의 고유값입니다.

설정된 식별자(Identifier)를 통해 해당 객체에 접근이 가능합니다.

Default Value:
  • null

labelBackgroundColorString

라벨 배경의 색상을 설정합니다.

Default Value:
  • transparent

labelBorderRadiusNumber

라벨 테두리의 둥근 정도를 설정합니다.

Default Value:
  • 0

labelBoxHeightOffsetNumber

라벨 배경의 추가 높이값을 설정합니다.

Default Value:
  • 0

labelBoxWidthOffsetNumber

라벨 배경의 추가 너비값을 설정합니다.

Default Value:
  • 0

labelGapNumber

눈금의 하단으로부터 라벨의 상단까지 간격을 픽셀 단위로 설정합니다.

Default Value:
  • 4

labelRotationNumber

라벨의 회전을 설정합니다.

라벨을 장치 글꼴(device fonts)로 렌더링하면 라벨은 항상 수평 방향으로 출력됩니다.

Default Value:
  • 0

lineBreakWidthNumber

autoLineBreak 속성값이 true 인 경우 라벨을 줄 바꿈할 지 여부를 판단하는 기준이 되는 길이 값을 설정합니다.

기본값(-1)으로 설정되어 있을 경우, placement 속성값이 top, bottom 이면 값은 자동으로 계산되고, left, right 이면 값은 100 이 적용됩니다.

Default Value:
  • -1

minorTickLengthNumber

축의 보조 눈금의 길이를 픽셀 단위로 설정합니다.

Default Value:
  • 0

minorTickPlacementString

축의 보조 눈금을 표시하는 위치를 설정합니다.

유효값은 다음과 같습니다.


  • inside - 보조 눈금을 데이터 영역 내에 표시합니다.

  • outside - 보조 눈금을 라벨 영역 내에 표시합니다.

  • cross - 보조 눈금을 축 상에 표시합니다.

  • none - 보조 눈금을 표시하지 않습니다.

Default Value:
  • cross

minorTickStrokeObject

축 상의 작은 눈금의 선(stroke) 스타일을 설정합니다.

유효값은 Stroke 클래스의 인스턴스입니다.

Default Value:
  • Stroke("#ffffff", 1, 1);

placementString

차트에서 축이 표시될 위치를 설정하는 속성입니다.

기본값(default)은 첫번째 축이 왼쪽(수직 축)과 아래(수평 축)이며, 두번째 축이 오른쪽과 위에 배치됩니다.

카테시안 차트에서는 자동적으로 두번째 축이 첫번째 축의 반대 방향에 위치하게 됩니다.

예를 들어, 첫번째 수직 축을 오른쪽에 배치하면, 두번째 수직 축은 왼쪽에 배치됩니다.

유효값은 수직 축인 경우 left 와 right 이며, 수평 축인 경우 top 과 bottom 입니다.

Default Value:
  • null

showLabelsBoolean

라벨의 표시 여부를 설정합니다.

Default Value:
  • true

showLineBoolean

실제 축의 표시 여부를 설정합니다.

Default Value:
  • false

textAlignString

축 라벨이 개행처리 되었을 경우 라벨의 총 넓이(width)를 기준으로 한 수평정렬 방식을 설정합니다.

유효값은 left, center, right 입니다.

Default Value:
  • center

tickLengthNumber

축의 눈금의 길이를 픽셀 단위로 설정합니다.

Default Value:
  • 5

tickPlacementString

축의 눈금(tick)을 표시하는 위치를 설정합니다.

유효값은 다음과 같습니다.


  • inside - 눈금을 데이터 영역 내에 표시합니다.

  • outside - 눈금을 라벨(label) 영역 내에 표시합니다.

  • cross - 눈금을 축 상에 표시합니다.

  • none - 눈금을 표시하지 않습니다.

Default Value:
  • outside

tickStrokeObject

축의 눈금을 표시하는 선의 속성을 설정합니다.

유효값은 Stroke 클래스의 인스턴스입니다.

Default Value:
  • Stroke("#f1f1f1", 1, 1);

titleGapNumber

축 타이틀과 축 사이에 있는 여백의 크기를 설정합니다.

Default Value:
  • 2

verticalAxisTitleAlignmentString

축 타이틀의 출력 위치를 설정합니다.

유효값은 flippedVertical, vertical, horizontal, top, bottom, upwardVertical 입니다.

Default Value:
  • flippedVertical

Methods

labelJsFunction(id, value)

축 라벨을 사용자 정의 라벨로 표현하기 위한 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 labelJsFunction 속성값을 자바스크립트 함수명으로 설정합니다.

<horizontalAxisRenderers>
  <Axis2DRenderer axis="{hAxis}" labelJsFunction="axisLabelFunc" .../>
</horizontalAxisRenderers>
...
function axisLabelFunc(id, value) {
  return value+"%";
}
Name Type Description
id String

축의 식별자(Identifier)

value String

축의 라벨값