API
SparkSeriesOptions

SparkSeriesOptions extends ValueSeriesOptions

subinterfaces OrthogonalSparkSeriesOptions, PieSeriesOptions, WaffleSeriesOptions

특정 위치에 연관된 값들을 단순 차트(spark chart)로 표시한다.
bar, line, par 차트가 제공된다.

Options

callout: boolean (opens in a new tab) | DataPointCalloutOptions

default :undefined

categories: Array (opens in a new tab)<SparkSeriesCategory>

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

default :undefined

color: string (opens in a new tab) | number (opens in a new tab)

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

default :undefined

colorField: string (opens in a new tab)

data point의 값이 객체일 때 색상 필드 명.
undefined이면, data point의 값이 객체일 때 'color'.

default :undefined

data: any (opens in a new tab)

default :undefined

dataUrl: string (opens in a new tab)

시리즈 데이터의 URL. createChartAsync 호출 시, 해당 url로 GET 요청을 전송하여 데이터를 다운받고,
해당 시리즈의 data 속성에 저장한다.

default :undefined

fields: Array (opens in a new tab)<string (opens in a new tab)>

data가 array로 제공되어 datapoint로 생성될 때, array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.

default :undefined

hoverStyle: SVGStyles | string (opens in a new tab)

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

default :undefined

idField: string (opens in a new tab)

data point의 값이 객체일 때 id 필드 명.

default :'id'

label: string (opens in a new tab)

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

default :undefined

latField: string (opens in a new tab)

data point의 값이 객체일 때 위도 필드 명.

default :'lat'

legendByCategory: boolean (opens in a new tab)

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

default :undefined

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

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

default :undefined

lonField: string (opens in a new tab)

data point의 값이 객체일 때 경도 필드 명.

default :'lon'

map: string (opens in a new tab) | number (opens in a new tab)

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

default :undefined

minSize: number (opens in a new tab)

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

default :undefined

name: string (opens in a new tab)

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

default :undefined

nameField: string (opens in a new tab)

data point의 값이 객체일 때 name 필드 명.

default :'name'

onPointAdded: (p: DataPointCallbackArgs) => void (opens in a new tab)

default :undefined

onPointClick: (args: DataPointCallbackArgs) => boolean (opens in a new tab)

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

default :undefined

onPointHover: (args: DataPointCallbackArgs) => void (opens in a new tab)

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

default :undefined

onPointRemoved: (p: DataPointCallbackArgs) => void (opens in a new tab)

default :undefined

onPointsLoaded: (series: object (opens in a new tab), firstTime: boolean (opens in a new tab)) => void (opens in a new tab)

default :undefined

pointColors: string (opens in a new tab) | Array (opens in a new tab)<string (opens in a new tab) | >>

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

default :undefined

pointLabel: boolean (opens in a new tab) | DataPointLabelOptions

데이터포인트 label 설정 옵션.

default :undefined

style: SVGStyles | string (opens in a new tab)

스타일셋 혹은 class selector.

default :undefined

styleCallback: (args: DataPointCallbackArgs) => SVGStyles|string (opens in a new tab)

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

default :undefined

tooltipCallback: (args: any (opens in a new tab)) => string (opens in a new tab)

default :undefined

tooltipText: string (opens in a new tab)

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

default :undefined

type: string (opens in a new tab)

default :undefined

valueField: string (opens in a new tab)

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

default :undefined

visible: boolean (opens in a new tab)

표시 여부.

default :true

visibleInLegend: boolean (opens in a new tab)

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

default :true