MapSeriesOptions extends ValueSeriesOptions
Map area 영역들을 칠하는 시리즈.
type
은 'map'이다.
choropleth map(단계 구분도. 색상으로 area별 특성을 나타내는 지도).
설정에서 type을 지정하지 않으면 생성되는 기본 시리즈이다.
Map chart가 지도처럼 보이려면 반드시 하나 이상의 map series가 포함되어야 한다.
Options
allAreas: boolean
(opens in a new tab)
true로 지정하면 data point가 설정되지 않은 area들도 nullColor로 표시한다.
복수 개의 시리즈로 영역들을 그룹핑하려면 반드시 false로 지정해야 한다.
default :true
bringToFront: boolean
(opens in a new tab)
true로 지정하면 데이터포인트가 설정된 area들이 설정되지 않은 area보다 위에 그려지게 한다.
default :false;
callout: boolean
(opens in a new tab) | DataPointCalloutOptions
default :undefined
color: string
(opens in a new tab) | number
(opens in a new tab)
데이터 포인트 기본 색.
숫자로 지정하면 정수로 변환된 값에 해당하는 팔레트 색상으로 설정된다.
'var(--color-n)'으로 지정한 것과 동일하며, 1 ~ 12 사이의 값으로 지정한다.
style
로 지정된 색상보다는 우선하지만,
pointColors
나 styleCallback
으로 설정된 색상이 이 속성으로 설정한 색상보다 우선한다.
default :undefined
colorField: string
(opens in a new tab)
data point의 값이 객체일 때 색상 필드 명.
undefined이면, data point의 값이 객체일 때 'color'.
default :undefined
colorRange: ColorRange
default :undefined
colorScale: string
(opens in a new tab) | number
(opens in a new tab)
차트에 설정된 color scale 아이디 혹은 인덱스.
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
detailKey: string
(opens in a new tab)
default :undefined
detailZoom: number
(opens in a new tab)
default :undefined
drilldown: DrilldownOptions
default :undefined
dummyStyle: SVGStyles
| string
(opens in a new tab)
dummy area에 설정되는 스타일셋.
default :undefined
fields: Array
(opens in a new tab)<string
(opens in a new tab)>
data
가 array로 제공되어 datapoint로 생성될 때,
array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.
default :undefined
hoverColor: string
(opens in a new tab)
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'
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
mapKeys: string
(opens in a new tab) | \[
| string
(opens in a new tab) | string
(opens in a new tab) | ]
맵 area와 연결할 키값들을 지정한다.
두 값을 배열로 지정하면 첫번째 문자열은 맵소스 "properties"의 속성명,
두번째는 데이터포인트의 속성명이다.
값을 하나만 지정하면 양쪽 같은 속성명으로 연결한다.
이 값이 지정되면 데이터포인트의 "id" 또는 idField 속성으로 지정한 속성값과 맵소스의 "rm-id" 또는 "id" 속성값으로 연결한다.
default :undefined
middleKeys: \[
| string
(opens in a new tab) | string
(opens in a new tab) | ]
default :undefined
name: string
(opens in a new tab)
시리즈 이름.
시리즈를 구분하기 위한 이름으로 사용된다.
default :undefined
nameField: string
(opens in a new tab)
data point의 값이 객체일 때 name 필드 명.
default :'name'
nullHovering: boolean
(opens in a new tab)
true로 지정하면 data가 연결되지 않은 area도 마우스 hover 효과가 표시된다.
default :false
nullStyle: SVGStyles
| string
(opens in a new tab)
데이터포인트가 연결되지 않은 area의 스타일.
default :undefined
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
selectable: boolean
(opens in a new tab)
true로 지정하면 마우스 클릭 등으로 area를 선택할 수 있다.
default :false
selectedStyle: SVGStyles
| string
(opens in a new tab)
선택된 area에 적용할 스타일셋.
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: 'map'
default :undefined
useMapData: boolean
(opens in a new tab)
true로 지정하면 데이터포인트로 지정되지 않은 area들에 대해,
map 모델의 속성들을 이용해서 각 area에 해당하는 data point들을 자동 생성한다.
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