series[type=pie]

value로 지정된 연관된 값들을 waffle 차트로 표시한다.
type은 'waffle'이다.

Route 시리즈 데모

Options

callout

데이터포인트 위치에서 선을 그어 떨어뜨려 표시하는 옵션.
데이터가 밀집된 지역이나 겹치는 값들 사이에서 분리하여 배치하기 위해 사용한다.
데이터포인트에 callout 속성이 [경도, 위도] 형식으로 지정되면 그 위치에 표시하고, offset 속성이 지정되면 원래 표시 위치에서 [경도 변화량, 위도 변화량]으로 지정한 값들 만큼 이동시킨다.
ex) { callout: [[127.2, 35.3], [127.9, 35.3]], ... }
ex) { offset: [[0, 2], [1, -1]], ... }

categories: SparkSeriesCategory[]

데이터포인트의 값이 복수개일 때 값별 색상을 순서대로 지정한다.
color 항목이 설정되지 않으면 데이터포인트의 기본 색상이 사용된다. 또, legendByCategory가 true이면 여기에 지정된 색상별로 legend에 표시된다.

colCount: number

default :10

color: string|number

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

colorField: string|number

data로 전달되는 데이터포인트 생성 객체들의 'color' 속성 값 대신, 이 속성으로 지정된 값을 데이터포인트의 기본 색상으로 적용한다.

default :'color'

data: any

데이터포인트 목록을 생성하는 데 참조되는 데이터셋.
createChartAsync를 호출해서 비동기로 맵차트를 생성할 때는 dataUrl로 원격 데이터 소스를 지정할 수 있다. [주의] 처음 load 후 data의 내용을 변경해도 맵차트에 반영되지 않는다.

dataPath: string

data나 dataUrl로 지정된 데이터소스에서 시리즈 데이터로 가져올 배열의 위치를 지정한다.
"aaa.bbb" 형식으로 지정한다. 배열 항목은 숫자로 지정한다. "aaa.2.bbb". 지정하지 않으면 최상위 JSON 객체를 그대로 사용한다.

dataUrl: string

시리즈 데이터의 외부 경로.
createChartAsync 호출 시, 해당 url로 GET 요청을 전송하여 데이터를 다운받고, 해당 시리즈의 data 속성에 저장한다.
data가 설정되면 이 속성은 무시된다. 또, 비동기 함수가 아닌 createChart로 맵차트를 생성할 때 이 속성으로 data를 설정하려는 경우 콘솔에 경고 메시지가 표시된다.

disabled: boolean

true로 설정하면 hovering을 포함한 마우스 등의 포인터에 반응하지 않는다.

excludeBounds: MapCoord[]

데이터포인트를 표시하지 않는 영역(들)을 지정한다.
[왼쪽위, 오른쪽아래, ...] 형태로 두 위치를 연속적으로 지정해서 복수 개의 영역을 설정할 수 있다.

fields: string[]

data가 array로 제공되어 datapoint로 생성될 때, array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.
ex) ['id', 'lon', 'lat', 'name', 'color']

fillDirection: 'col'|'row'

cell 들을 채워나가는 방향을 지정한다.

• 'col' 왼쪽 행(column)부터 오른쪽로 채워가면서 fillThreshold에 도달하면 위쪽으로 채워 나간다.
  
• 'row' 야래쪽 행(row)부터 위로 채워가면서 fillThreshold에 도달하면 오른쪽으로 채워 나간다.
  

default :'col'

fillThreshold: number

fillDirection이 'colFirst'나 'rowFirst'일 때, 방향을 바꾸게 하는 기준 셀 개수.
1 이상이어야 하고, fillDirection에 따라 rowCount나 colCount 미만 크기로 지정해야 한다.

default :1

idField: string|number

data로 전달되는 데이터포인트 생성 객체들의 'id' 속성 값 대신, 이 속성으로 지정된 값을 데이터포인트 id로 설정한다.

default :'id'

label: string

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

latField: string|number

data로 전달되는 데이터포인트 생성 객체들의 'lat' 속성 값 대신, 이 속성으로 지정된 값을 데이터포인트 위도 값으로 설정한다.

default :'lat'

legend: string|number

이 시리즈가 연결된 legend를 legend의 index나 이름으로 지정한다.
범위를 벗어난 index 등 잘못된 값을 지정하면 legend에 표시되지 않는다. 특별히 지정하지 않으면 첫 번째 index에 표시된다.

default :0

legendByCategory: boolean

true로 지정되고 categories가 지정되면 맵차트 legend에 category별로 항목이 표시된다.

default :undefined

lonField: string|number

data로 전달되는 데이터포인트 생성 객체들의 'lon' 속성 값 대신, 이 속성으로 지정된 값을 데이터포인트 경도 값으로 설정한다.

default :'lon'

map: string|number

명시적으로 이 속성을 지정하면, 관련된 맵이 맵차트에 활성됐을 때만 시리즈가 표시된다.

maxValue: number

valueDomain 설정에 따라 개별 데이터포인트나 시리즈의 전체 데이터포인트 값들로 부터 계산된 최대값 보다 이 속성에 지정한 값이 크면 그 값을 기준 최대값으로 한다.

minCount: number

최소 cell 개수.

default :1

minSize: number

이 값을 0보다 크고 1보다 작은 값으로 지정하면, 데이터포인트 최대값을 기준으로 기본 크기에 대한 상대 크기로 표시된다.

default :undefined

minValue: number

valueDomain 설정에 따라 개별 데이터포인트나 시리즈의 전체 데이터포인트 값들로 부터 계산된 최소값 보다 이 속성에 지정한 값이 작으면 그 값을 기준 최소값으로 한다.

name: string

시리즈 이름.
시리즈를 구분하기 위한 이름으로 사용된다.

nameField: string|number

data로 전달되는 데이터포인트 생성 객체들의 'name' 속성 값 대신, 이 속성으로 지정된 값을 데이터포인트 이름으로 설정한다.

default :'name'

onPointAdded: ( args: DataPointArgs ) => void

addPoint를 호출해서 데이터포인트가 하나 추가된 후 호출된다.

onPointClick: ( args: DataPointArgs ) => boolean

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

onPointHover: ( args: DataPointArgs ) => void

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

onPointRemoved: ( args: DataPointArgs ) => void

removePoint를 호출해서 데이터포인트가 하나 제거된 후 호출된다.

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

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

pointColors: string|string[]|string

color 속성이 명시적으로 지정되지 않은 데이터포인터의 color 속성을 지정한다.
색 배열로 지정하거나, 'colors' asset으로 등록된 이름을 지정할 수 있다.
시리즈 style이나 color로 지정된 색 보다는 우선하지만, styleCallback에서 설정된 색상이나 데이터포인트별로 지정한 색상이 이 속성으로 설정된 색상보다 우선한다.

pointLabel

데이터포인트 label 설정 옵션.
boolean (opens in a new tab)으로 지정하면 visible 속성을, 문자열로 지정하면 text 속성을 별도로 지정하는 것과 동일하다.

position: 'bottom'|'center'|'left'|'right'|'top'

데이터포인트 좌표 기준 spark chart 표시 위치.

• 'bottom' 데이터포인트 위치가 이미지 등 아이템의 위쪽이 되도록 표시한다.
  
• 'center' 데이터포인트 위치가 이미지 등 아이템의 중앙이 되도록 표시한다.
  
• 'left' 데이터포인트 위치가 이미지 등 아이템의 오른쪽이 되도록 표시한다.
  
• 'right' 데이터포인트 위치가 이미지 등 아이템의 왼쪽이 되도록 표시한다.
  
• 'top' 데이터포인트 위치가 이미지 등 아이템의 아래쪽이 되도록 표시한다.
  

default :'top'

rotation: number

데이터포인트 도형 회전 각도.

roundingMethod: 'round'|'trunc'

default :'round'

rowCount: number

default :10

showNull: boolean

true로 지정하면 값에 포함되지 않는 셀들을 nullStyle을 적용해서 표시한다.

default :false;

style: SVGStyles|string

스타일셋 혹은 class selector.

styleCallback: ( args: DataPointArgs ) => SVGStyles|string|undefined

데이터 point의 동적 스타일 콜백.
style, pointColors 등 다른 스타일 설정들 보다 우선한다.

tooltipCallback: ( args: DataPointArgs ) => string

동적으로 tooltipText를 리턴하는 콜백.
null이나 undefined를 리턴하면 tooltipText 설정을 따른다.

tooltipText: string|boolean

데이터포인트 툴팁 텍스트.
true로 지정하면 기본 툴팁이 적용되고, false로 지정하면 tooltip이 표시되지 않는다.

type: 'waffle'

시리즈 종류를 지정한다.
지정하지 않으면 'map' 시리즈로 생성된다.

default :waffle

valueDomain: 'point'|'series'

• 'point'
• 'series'

default :'series'

valueField: string

data로 전달되는 데이터포인트 생성 객체들의 'value' 속성 값 대신, 이 속성으로 지정된 값을 데이터포인트 값으로 적용한다.

valueFields: string[]

데이터포인트 값들을 가져올 필드 목록.
이 속성이 지정되면 valueField는 무시된다.

visible: boolean

표시 여부.

default :true