rMateChart v7.0

new TreeMapSeries()

TreeMapSeries 클래스는 TreeMapChart 클래스 인스턴스의 series 속성에 설정됩니다.

차트에 설정된 데이터를 처리하고 트리맵 차트를 표현합니다.

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

<rMateChart>
  <Options>
    <Caption text="Annual Report" />
  </Options>
  <TreeMapChart showDataTips="true">
    <series>
      <TreeMapSeries weightField="weight" nameField="name" groupField="group" groupNameField="groupName" />
    </series>
  </TreeMapChart>
</rMateChart>

Extends

Series

Members

alwayShowLabelsBoolean

라벨의 표시 공간이 충분하지 않을 경우에도 라벨을 표시할 지 여부를 설정합니다.

값이 true 이면 항상 라벨들을 표시하지만, false 인 경우에는 라벨의 표시 공간이 부족할 경우 표시하지 않습니다.

Default Value:

false

colorFieldString

ColorRangeLegend 클래스 인스턴스를 사용할 경우 ColorAxis 클래스 인스턴스를 설정합니다.

Default Value:

null

displayNameString

시리즈의 이름을 설정합니다.

설정된 값은 기본적으로 데이터 팁(툴팁)에서 보여지게 되고 범례의 항목으로 표시됩니다.

Default Value:

null

fillObject

시리즈 아이템렌더러의 채우기 색을 설정합니다.

Default Value:

null

fillsArray

차트에 표시되는 데이터가 여러개 일 때, 각 데이터에 서로 다른 색상을 설정합니다.

만약 데이터 수만큼의 색상 객체(SolidColor)가 설정되지 않으면 설정된 색상이 반복 적용됩니다.

예를 들어, 시리즈의 데이터 수가 10 이고 5 개의 색상 객체(SolidColor)가 설정되었다면, 5 개의 색상 객체가 처음 5 개의 데이터에 순서대로 적용되고 나머지 5 개의 데이터에는 5 개의 색상 객체가 다시 순차적으로 적용됩니다.

유효값은 SolidColor 클래스의 인스턴스 배열입니다.

<fills>
  <SolidColor color="0xCC66FF" />
  <SolidColor color="0x9966CC" />
  <SolidColor color="0x9999CC" />
</fills>

Default Value:

null

formatterObject

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

Default Value:

NumberFormatter

groupFieldString

차트를 계층형으로 표현할 경우 계층 그룹에 해당하는 데이터 필드명을 설정합니다.

Default Value:

null

groupHeaderColorHexadecimal

차트를 계층형으로 표현할 경우 계층 그룹명이 표시되는 헤더의 색상을 설정합니다.

Default Value:

#f0f4ef

groupHeaderFontColorHexadecimal

차트를 계층형으로 표현할 경우 계층 그룹명의 색상을 설정합니다.

Default Value:

#7c7c7c

groupHeaderFontFamilyString

차트를 계층형으로 표현할 경우 계층 그룹명의 폰트를 설정합니다.

Default Value:

null

groupHeaderFontFamilyString

차트를 계층형으로 표현할 경우 계층 그룹명의 폰트명을 설정합니다.

Default Value:

malgun gothic

groupHeaderFontSizeNumber

차트를 계층형으로 표현할 경우 계층 그룹명의 폰트 크기를 설정합니다.

Default Value:

groupHeaderFontWeightString

차트를 계층형으로 표현할 경우 계층 그룹명의 굵기를 설정합니다.

Default Value:

normal

groupHeaderHeightNumber

차트를 계층형으로 표현할 경우 계층 그룹명이 표시되는 헤더의 높이를 설정합니다.

Default Value:

groupHeaderTextAlignString

차트를 계층형으로 표현할 경우 계층 그룹명의 정렬 방식을 설정합니다.

Default Value:

center

groupLabelXOffsetNumber

그룹 라벨의 위치에서 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:

groupLabelYOffsetNumber

그룹 라벨의 위치에서 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:

groupNameFieldString

차트를 계층형으로 표현할 경우 계층 그룹명에 해당하는 데이터 필드명을 설정합니다.

Default Value:

null

groupStrokeHexadecimal

차트를 계층형으로 표현할 경우 계층 그룹명이 표시되는 헤더 테두리 선의 색상을 설정합니다.

Default Value:

#ffffff

idString

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

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

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

Default Value:

null

insideLabelRollOverVisibleNumber

LabelPosition이 inside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성

Default Value:

interactiveBoolean

시리즈에 마우스 오버시 데이터 팁을 보여줄 지 여부를 설정합니다.

Default Value:

true

itemRollOverColorHexadecimal

데이터 아이템에 마우스 오버했을 때의 색상을 설정합니다.

Default Value:

null

itemRollOverEmphasizeBoolean

데이터 아이템에 마우스 오버했을 때의 아이템을 강조합니다.

Default Value:

false

itemSelectionColorHexadecimal

데이터 아이템을 선택했을 떄의 색상을 설정합니다.

Default Value:

null

labelBackgroundColorString

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

Default Value:

transparent

labelBorderRadiusNumber

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

Default Value:

labelBoxHeightOffsetNumber

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

Default Value:

labelBoxWidthOffsetNumber

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

Default Value:

labelPositionString

데이터 아이템의 값(수치 라벨)이 표시될 위치를 설정합니다.

유효값은 inside, none 입니다.

Default Value:

none

nameFieldString

차트에서 사용될 데이터 중에서 라벨로 표시될 데이터 필드명을 설정합니다.

Default Value:

null

selectableBoolean

마우스로 데이터를 선택 가능하도록 할 지 여부를 설정합니다.

Default Value:

true

showGroupHeaderBoolean

차트를 계층형으로 표현할 경우 계층 그룹명을 표시할 지 여부를 설정합니다.

Default Value:

true

styleNameString

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

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

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

<Bar3DChart>
  <Bar3DSeries xField="Profit" styleName="seriesStyle">
  ...
</Bar3DChart>
<Style>
  .seriesStyle {fontFamily:"Malgun Gothic";labelPosition:inside;fontSize:11;paddingTop:4;color:0x000099;}
</Style>

Default Value:

null

topLevelGroupHeaderColorHexadecimal

차트를 계층형으로 표현할 경우 최상위 계층 그룹의 색상을 설정합니다.

Default Value:

#fff

topLevelGroupHeaderFontColorHexadecimal

차트를 계층형으로 표현할 경우 최상위 계층 그룹명의 색상을 설정합니다.

Default Value:

#6b6b6b

visibleBoolean

시리즈를 차트에 출력할 지 여부를 설정합니다.

Default Value:

true

weightFieldString

사용될 데이터 중에서 타일의 크기에 해당하는 데이터 필드명을 설정합니다.

Default Value:

null

Methods

inherited fillJsFunction(seriesId, index, data, values)

사용자 정의 색상을 설정하는 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 fillJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" fillJsFunction="fillJsFunc">
...
fillJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값

Name	Type	Description
`seriesId`	String	시리즈 식별자(Identifier)
`index`	Number	데이터 아이템의 인덱스
`data`	Object	데이터 아이템의 데이터 객체
`values`	Array	데이터 아이템의 데이터 배열

groupLabelJsFunction(seriesId, index, data, values)

사용자 정의 계층 그룹명을 설정하는 자바스크립트 함수명을 설정합니다.

<TreeMapSeries ... groupLabelJsFunction="groupLabelJsFunc">
...
groupLabelJsFunc(seriesId, index, data, values) {
  ...
}

Name	Type	Description
`seriesId`	String	시리즈 식별자(Identifier)
`index`	Number	데이터 아이템의 인덱스
`data`	Object	데이터 아이템의 데이터 객체
`values`	Array	데이터 아이템의 데이터 배열 0 : weight 값, 1 : text 값

inherited htmlJsFunction(seriesId, index, data, values)

차트의 데이터 아이템들 중에서 설정된 조건을 만족하는 데이터 아이템에 대해서 실핼될 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 htmlJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" htmlJsFunction="userElementFunc">
...
userElementFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값

Name	Type	Description
`seriesId`	String	시리즈 식별자(Identifier)
`index`	Number	데이터 아이템의 인덱스
`data`	Object	데이터 아이템의 데이터 객체
`values`	Array	데이터 아이템의 데이터 배열

labelJsFunction(seriesId, index, data, values)

사용자 정의 라벨(수치값)을 설정하는 자바스크립트 함수명을 설정합니다.

<TreeMapSeries ... labelJsFunction="labelJsFunc">
...
labelJsFunc(seriesId, index, data, values) {
  ...
}

Name	Type	Description
`seriesId`	String	시리즈 식별자(Identifier)
`index`	Number	데이터 아이템의 인덱스
`data`	Object	데이터 아이템의 데이터 객체
`values`	Array	데이터 아이템의 데이터 배열 0 : weight 값, 1 : text 값

inherited strokeJsFunction(seriesId, index, data, values)

아이템 렌더러에 의해 표현되는 아이템 테두리에 대한 사용자 정의 함수를 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 strokeJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" strokeJsFunction="strokeJsFunc">
...
strokeJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값

Name	Type	Description
`seriesId`	String	시리즈 식별자(Identifier)
`index`	Number	데이터 아이템의 인덱스
`data`	Object	데이터 아이템의 데이터 객체
`values`	Array	데이터 아이템의 데이터 배열

Class: TreeMapSeries

new TreeMapSeries()

Extends

Members

alwayShowLabelsBoolean

colorFieldString

displayNameString

fillObject

fillsArray

formatterObject

groupFieldString

groupHeaderColorHexadecimal

groupHeaderFontColorHexadecimal

groupHeaderFontFamilyString

groupHeaderFontFamilyString

groupHeaderFontSizeNumber

groupHeaderFontWeightString

groupHeaderHeightNumber

groupHeaderTextAlignString

groupLabelXOffsetNumber

groupLabelYOffsetNumber

groupNameFieldString

groupStrokeHexadecimal

idString

insideLabelRollOverVisibleNumber

interactiveBoolean

itemRollOverColorHexadecimal

itemRollOverEmphasizeBoolean

itemSelectionColorHexadecimal

labelBackgroundColorString

labelBorderRadiusNumber

labelBoxHeightOffsetNumber

labelBoxWidthOffsetNumber

labelPositionString

nameFieldString

selectableBoolean

showGroupHeaderBoolean

styleNameString

topLevelGroupHeaderColorHexadecimal

topLevelGroupHeaderFontColorHexadecimal

visibleBoolean

weightFieldString

Methods

inherited fillJsFunction(seriesId, index, data, values)

groupLabelJsFunction(seriesId, index, data, values)

inherited htmlJsFunction(seriesId, index, data, values)

labelJsFunction(seriesId, index, data, values)

inherited strokeJsFunction(seriesId, index, data, values)