series[type=pie]

Pie 시리즈
type은 'pie'이다.
모든 데이터포인트 값들의 합에 대한 데이터포인트의 상대적 값 비율을 원호로 표시한다.

data는 아래 형식들로 전달할 수 있다.

단일값 또는 단일값 배열

json 배열

Options

autoSlice: boolean

클릭한 데이터 포인트를 slice 시킨다.
기존 slice 됐던 포인트는 원복된다.

default :true

center: string|number

centerX, centerY를 지정하지 않으면 이 속성값을 사용한다.
즉, 이 속성으로 두 속성값을 동시에 지정할 수 있다.

centerX: string|number

body 영역을 기준으로 'pie', 'funnel' 시리즈들의 수평 중심 위치
숫자나 body 영역 너비에 대한 상대값을 '%'로 지정할 수 있다.

default :'50%'

centerY: string|number

body 영역을 기준으로 'pie', 'funnel' 시리즈들의 수직 중심 위치
숫자나 body 영역 높이에 대한 상대값을 '%'로 지정할 수 있다.

default :'50%'

clockwise: boolean

true면 시계 방향으로 회전한다.

default :true

col: number

분할 모드일 때 시리즈가 표시될 pane의 수평 index.

color: string|number

데이터 포인트 기본 색.
숫자로 지정하면 정수로 변환된 값에 해당하는 팔레트 색상으로 설정된다. 'var(--color-n)'으로 지정한 것과 동일하며, 1 ~ 12 사이의 값으로 지정한다.
pointColors나 pointStyleCallback으로 설정된 색상이 이 속성으로 설정한 색상보다 우선한다.

colorField: string

undefined이면, data point의 값이 객체일 때 'color'.

data: any

데이터포인터들을 생성하는 데 사용되는 값 목록.

groupSize: number

default :1

hoverEffect: 'none'|'default'

데이터포인트 hover 효과.

hoverStyle: SVGStyles|string

데이터포인트 위에 마우스가 있을 때 적용되는 스타일셋 또는 css selector (opens in a new tab).

innerRadius: string|number

0보다 큰 값을 지정해서 도넛 형태로 표시할 수 있다.
시리즈 원호의 반지름에 대한 상대적 크기나 픽셀 수로 지정할 수 있다. innerText로 도넛 내부에 표시될 텍스트를 지정할 수 있다.

innerText

innerRadius가 0보다 클 때, 도넛 내부에 표시되는 텍스트.
기본 클래스 selector는 'rct-pie-series-inner'이다.

label: string

이 시리즈를 나타내는 텍스트.
레전드나 툴팁에서 시리즈를 대표한다. 이 속성이 지정되지 않으면 name이 사용된다.

legendByPoint: boolean

true로 지정하면 'pie', 'funnel' 시리즈들의 데이터포인트별 legend 항목을 표시한다.

default :false

loadAnimation: 'default'|'reveal'|'grow'|'spread'|'fadein'

차트 설정 로드 시 실행되는 animation 종류.

name: string

시리즈 이름.
시리즈 생성시 지정된 후 변경할 수 없다. 차트의 다른 구성 요소에서 이 시리즈를 참조할 때 사용되며, 레전드나 툴팁에서 시리즈를 나타내는 텍스트로도 사용된다.

noClip: boolean

true로 지정하면 body를 벗어난 data point 영역도 표시된다.
값을 지정하지 않으면 polar 차트에서는 true, 직교 차트에서는 false이다. group에 포함되면 group의 noClip 설정을 따른다.
또, 값을 지정하지 않으면 버블시리즈는 최대한 버블들이 표시되도록 한다.

onPointClick: ( args: DataPointCallbackArgs ) => boolean

데이터 point가 클릭될 때 호출되는 이벤트 콜백.
명시적 true를 리턴하면 기본 동작이 진행되지 않는다.

onPointHover: ( args: DataPointCallbackArgs ) => void

마우스가 데이터 point 위에 올라가거나 빠져나갈 때 호출되는 이벤트 콜백.
빠져나가는 경우 args 매개변수는 null이다.

onPointsLoaded: ( series: object, firstTime: boolean ) => void

데이터포인트들이 새로 로드된 후 호출된다.

pointColors: string|string[]

데이터 포인트별 색들을 지정한다.
색 배열로 지정하거나, 'colors' asset으로 등록된 이름을 지정할 수 있다.
pointStyleCallback으로 설정된 색상이나 데이터포인트별로 지정한 색상이 이 속성으로 설정한 색상보다 우선한다.

pointLabel

pointStyle: SVGStyles|string

모든 데이터포인트에 적용되는 스타일셋 또는 css selector (opens in a new tab).
style로 설정되는 시리즈의 inline 스타일이 데이터포인터에 적용되지 않는 경우 이 속성을 사용할 수 있다. pointColors나 color가 설정되면 이 속성으로 설정된 색상은 무시된다. 또, pointStyleCallback으로 설정된 스타일이 이 속성 스타일보다 우선한다.

pointStyleCallback: ( args: DataPointCallbackArgs ) => SVGStyles|string

데이터포인트의 동적 스타일 콜백.

radius: string|number

시리즈 원호의 반지름.
픽셀 크기나 body 영역 크기에 대한 상대적 크기로 지정할 수 있다. '50%'로 지정하면 plot 영역의 width나 height중 작은 크기와 동일한 반지름으로 표시된다.

default :'40%

row: number

분할 모드일 때 시리즈가 표시될 pane의 수직 index.

sliceDuration: number

Slice animation duration.
밀리세컨드(ms) 단위로 지정.

default :300

sliceOffset: string|number

default :'7%'

startAngle: number

시리즈 원호 시작 각도.
지정하지 않거나 잘못된 값이면 0으로 계산된다. 0은 시계의 12시 위치다.

default :0

style: SVGStyles|string

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

tooltipCallback: ( args: any ) => string

tooltipText: string

데이터포인트 툴팁 텍스트.

totalAngle: number

시리즈 원호 전체 각도.
0 ~ 360 사이의 값으로 지정해야 한다. 범위를 벗어난 값은 범위 안으로 조정된다. 지정하지 않거나 잘못된 값이면 360으로 계산된다.

default :360

type: 'pie'

viewRangeValue: 'x'|'y'|'z'

ranges가 적용되는 값.
지정하지 않으면 시리즈 종류에 띠라 자동 적용된다. 'line' 시리즈 계열은 'x', 나머지는 'y'가 된다. 현재 'z'은 range는 bubble 시리즈에만 적용할 수 있다.

viewRanges: ValueRangeList | ValueRange[]

값 범위 목록.
범위별로 다른 스타일을 적용할 수 있다. 범위들은 중첩될 수 없다.

visible: boolean

표시 여부.

default :true

visibleInLegend: boolean

명시적 false로 지정하면 legend에 표시하지 않는다.

visibleInNavigator: boolean

true로 지정하면 시리즈 내비게이터에 표시한다.

visibleThreshold: number

포인터가 차지하는 너비가 이 값 미만이면 표시하지 않는다.

xAxis: string|number

그룹에 포함되면 그룹 설정을 따른다.

xField: string|number

json 객체나 배열로 전달되는 데이터포인트 정보에서 x 값을 지정하는 속성명이나 인덱스.
undefined이면, data point의 값이 array일 때는 0, 객체이면 'x'.

xStart: any

연결된 x축이 연속 축(카테고리축이 아닌)일 때, x축 값이 설정되지 않은 첫번째 데이터 point에 설정되는 x값.
이 후에는 xStep씩 증가시키면서 설정한다. 이 속성이 지정되지 않은 경우 xStart가 적용된다.

xStep: string|number

연결된 x축이 연속 축(카테고리축이 아닌)일 때, x축 값이 설정되지 않은 데이터 point에 지정되는 x값의 간격.
첫번째 값은 xStart로 설정한다. time 축일 때, 정수 값 대신 시간 단위('y', 'm', 'w', 'd', 'h', 'n', 's')로 지정할 수 있다. 이 속성이 지정되지 않으면 xStep이 적용된다.

yAxis: string|number

그룹에 포함되면 그룹 설정을 따른다.

yField: string|number|Function

json 객체나 배열로 전달되는 데이터포인트 정보에서 y 값을 지정하는 속성명이나 인덱스.
undefined이면, data point의 값이 array일 때는 1, 객체이면 'y'.

zField: string|number|Function

json 객체나 배열로 전달되는 데이터포인트 정보에서 z 값을 지정하는 속성명이나 인덱스.
undefined이면, data point의 값이 array일 때는 2, 객체이면 'z'.

zOrder: number

시리즈 표시 순서를 지정할 수 있다.
값이 클 수록 나중에(위에) 표시된다.

zeroInLegend: boolean

값이 0인 데이터포인트를 범례 항목으로 표시할 것인 지 여부.

default :true