HtmlSeriesOptions extends ValueSeriesOptions
지정된 지점에 html을 표시하는 시리즈.
type은 'html'이다.
Html 시리즈 데모Options
callout: boolean (opens in a new tab) | DataPointCalloutOptions
데이터포인트 위치에서 선을 그어 떨어뜨려 표시하는 옵션.
데이터가 밀집된 지역이나 겹치는 값들 사이에서 분리하여 배치하기 위해 사용한다.
데이터포인트에 callout 속성이 [경도, 위도] 형식으로 지정되면 그 위치에 표시하고,
offset 속성이 지정되면 원래 표시 위치에서 [경도 변화량, 위도 변화량]으로 지정한 값들 만큼 이동시킨다.
ex) { callout: [[127.2, 35.3], [127.9, 35.3]], ... }
ex) { offset: [[0, 2], [1, -1]], ... }
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) | number (opens in a new tab)
data로 전달되는 데이터포인트 생성 객체들의 'color' 속성 값 대신,
이 속성으로 지정된 값을 데이터포인트의 기본 색상으로 적용한다.
default :'color'
data: any (opens in a new tab)
데이터포인트 목록을 생성하는 데 참조되는 데이터셋.
createChartAsync를 호출해서 비동기로
맵차트를 생성할 때는 dataUrl로 원격 데이터 소스를 지정할 수 있다.
[주의] 처음 load 후 data의 내용을 변경해도 맵차트에 반영되지 않는다.
default :undefined
dataPath: string (opens in a new tab)
data나 dataUrl로 지정된 데이터소스에서 시리즈 데이터로 가져올 배열의 위치를 지정한다.
"aaa.bbb" 형식으로 지정한다. 배열 항목은 숫자로 지정한다. "aaa.2.bbb".
지정하지 않으면 최상위 JSON 객체를 그대로 사용한다.
default :undefined
dataUrl: string (opens in a new tab)
시리즈 데이터의 외부 경로.
createChartAsync 호출 시, 해당 url로 GET 요청을 전송하여 데이터를 다운받고,
해당 시리즈의 data 속성에 저장한다.
data가 설정되면 이 속성은 무시된다.
또, 비동기 함수가 아닌 createChart로 맵차트를 생성할 때 이 속성으로 data를 설정하려는 경우
콘솔에 경고 메시지가 표시된다.
default :undefined
disabled: boolean (opens in a new tab)
true로 설정하면 hovering을 포함한 마우스 등의 포인터에 반응하지 않는다.
default :undefined
fields: Array (opens in a new tab)<string (opens in a new tab)>
data가 array로 제공되어 datapoint로 생성될 때,
array의 각 항목에 해당하는 이름으로 datapoint source의 값을 사용한다.
ex) ['id', 'lon', 'lat', 'name', 'color']
default :undefined
idField: string (opens in a new tab) | number (opens in a new tab)
data로 전달되는 데이터포인트 생성 객체들의 'id' 속성 값 대신,
이 속성으로 지정된 값을 데이터포인트 id로 설정한다.
default :'id'
label: string (opens in a new tab)
이 시리즈를 나타내는 텍스트.
레전드나 툴팁에서 시리즈를 대표한다.
이 속성이 지정되지 않으면 name이 사용된다.
default :undefined
latField: string (opens in a new tab) | number (opens in a new tab)
data로 전달되는 데이터포인트 생성 객체들의 'lat' 속성 값 대신,
이 속성으로 지정된 값을 데이터포인트 위도 값으로 설정한다.
default :'lat'
legend: string (opens in a new tab) | number (opens in a new tab)
이 시리즈가 연결된 legend를 legend의 index나 이름으로 지정한다.
범위를 벗어난 index 등 잘못된 값을 지정하면 legend에 표시되지 않는다.
특별히 지정하지 않으면 첫 번째 index에 표시된다.
default :0
lonField: string (opens in a new tab) | number (opens in a new tab)
data로 전달되는 데이터포인트 생성 객체들의 'lon' 속성 값 대신,
이 속성으로 지정된 값을 데이터포인트 경도 값으로 설정한다.
default :'lon'
map: string (opens in a new tab) | number (opens in a new tab)
명시적으로 이 속성을 지정하면, 관련된 맵이 맵차트에 활성됐을 때만 시리즈가 표시된다.
default :undefined
name: string (opens in a new tab)
시리즈 이름.
시리즈를 구분하기 위한 이름으로 사용된다.
default :undefined
nameField: string (opens in a new tab) | number (opens in a new tab)
data로 전달되는 데이터포인트 생성 객체들의 'name' 속성 값 대신,
이 속성으로 지정된 값을 데이터포인트 이름으로 설정한다.
default :'name'
onPointAdded: (args: DataPointArgs) => void (opens in a new tab)
default :undefined
onPointClick: PointClickCallback
데이터 point가 클릭될 때 호출되는 이벤트 콜백.
명시적 true를 리턴하면 기본 동작이 진행되지 않는다.
default :undefined
onPointHover: PointHoverCallback
마우스가 데이터 point 위에 올라가거나 빠져나갈 때 호출되는 이벤트 콜백.
빠져나가는 경우 args 매개변수는 null이다.
default :undefined
onPointRemoved: (args: DataPointArgs) => 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
params: | (param: string (opens in a new tab)) => any (opens in a new tab)
html로 지정된 html 텍스트에 포함된 param 값을 지정하는 객체나 콜백. #311
default :undefined
pointColors: string (opens in a new tab) | Array (opens in a new tab)<string (opens in a new tab)> | (point: DataPointArgs) => string (opens in a new tab)
color 속성이 명시적으로 지정되지 않은 데이터포인터의 color 속성을 지정한다.
색 배열로 지정하거나, 'colors' asset으로 등록된 이름을 지정할 수 있다.
시리즈 style이나 color로 지정된 색 보다는 우선하지만,
styleCallback에서 설정된 색상이나 데이터포인트별로 지정한 색상이 이 속성으로 설정된 색상보다 우선한다.
default :undefined
pointLabel: boolean (opens in a new tab) | HtmlSeriesLabelOptions
visible 기본값이 false이다.
default :undefined
position: PointViewPosition
'bottom'데이터포인트 위치가 이미지 등 아이템의 위쪽이 되도록 표시한다.'center'데이터포인트 위치가 이미지 등 아이템의 중앙이 되도록 표시한다.'left'데이터포인트 위치가 이미지 등 아이템의 오른쪽이 되도록 표시한다.'right'데이터포인트 위치가 이미지 등 아이템의 왼쪽이 되도록 표시한다.'top'데이터포인트 위치가 이미지 등 아이템의 아래쪽이 되도록 표시한다.
default :'center'
style: SVGStyleOrClass
스타일셋 혹은 class selector.
default :undefined
styleCallback: PointStyleCallback
데이터 point의 동적 스타일 콜백.
style, pointColors 등 다른 스타일 설정들 보다 우선한다.
default :undefined
tooltipCallback: (args: DataPointArgs) => string (opens in a new tab)
default :undefined
tooltipText: string (opens in a new tab) | boolean (opens in a new tab)
데이터포인트 툴팁 텍스트.
true로 지정하면 기본 툴팁이 적용되고, false로 지정하면 tooltip이 표시되지 않는다.
default :undefined
valueField: string (opens in a new tab)
data로 전달되는 데이터포인트 생성 객체들의 'value' 속성 값 대신,
이 속성으로 지정된 값을 데이터포인트 값으로 적용한다.
default :undefined
visible: boolean (opens in a new tab)
표시 여부.
default :true