series[type=lollipop]

Lollipop(막대 사탕) 시리즈.
기능적으로는 bar 시리즈와 동일하지만, 대부분의 데이터포인트 값들이 최대값에 가까운 곳에 몰려 있는 경우에 활용 가능하다. bar 시리즈 표현하면 시각적으로 구분하기 쉽지 않기 때문이다. 특히, bar가 겹치더라도 데이터포인트들이 쉽게 구분된다.

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

단일 값 및 값 배열

json 배열

Properties

baseValue: number

상/하 값 구분의 기준이 되는 값.

숫자가 아닌 값으로 지정하면 0으로 간주한다.

default: 0

belowStyle: SVGStyles | string

baseValue 혹은 y축의 baseValue보다 작은 쪽의 point들에 적용되는 스타일.

• SVGStyles

col: number

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

default: undefined

color: string | number

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

default: undefined

colorField: string

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

default: undefined

data: any

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

default: undefined

hoverStyle: SVGStyles | string

데이터포인트 위에 마우스가 있을 때 적용되는 스타일셋 혹은 class selector.

• SVGStyles

label: string

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

default: undefined

name: string

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

default: undefined

noClip: boolean

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

default: undefined

nullAsBase: boolean

null인 y값을 baseValue 로 간주한다.

default: false

onPointClick

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

default: undefined

onPointHover

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

default: undefined

pointColors: string | string[]

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

default: undefined

pointLabel

데이터포인트 label 설정 모델.

default: undefined

pointPadding: number

이 시리즈의 point가 차지하는 영역 중에서 point bar 양쪽 끝에 채워지는 빈 영역의 크기.

point가 차지할 원래 크기에 대한 상대 값으로서, 0 ~ 0.5 사이의 비율 값으로 지정한다.

default: undefined 한 카테고리에 cluster 가능한 시리즈가 하나만 표시되면 0.25, group에 포함된 경우 0.1, 여러 시리즈와 같이 표시되면 0.2.

pointStyle: SVGStyles | string

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

• SVGStyles

pointStyleCallback

데이터 point의 동적 스타일 콜백.

default: undefined

pointWidth: number

시리즈가 그룹에 포함되지 않거나, 포함된 그룹의 layout이 default 이거나 특별히 설정되지 않아서, 그룹에 포함된 시리즈들의 data point가 옆으로 나열되어 표시될 때, 포인트 표시 영역 내에서 이 시리즈의 포인트가 차지하는 영역의 상대 크기. 예를 들어 이 시리즈의 속성값이 1이고 다른 시리즈의 값이 2이면 다른 시리즈의 data point가 두 배 두껍게 표시된다. 또, 그룹에 포함되고 그룹의 layout이 default

default: 1

row: number

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

default: undefined

style: SVGStyles | string

스타일셋 혹은 class selector.

• SVGStyles

tooltipText: string

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

default: '<b>${name}</b><br>${series}:<b> ${yValue}</b>'

trendline

추세선 설정 모델.

default: undefined

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

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

default: undefined

viewRanges: IValueRanges | IValueRange[]

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

default: undefined

visible: boolean

표시 여부.

default: true

visibleInLegend: boolean

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

default: true

xAxis: string | number

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

default: undefined

xField: string | number

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

default: undefined

xStart: any

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

default: undefined

xStep: string | number

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

default: undefined

yAxis: string | number

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

default: undefined

yField: string | number | Function

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

default: undefined

zField: string | number | Function

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

default: undefined

zOrder: number

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

default: 0