release 1.1.1
새로운 기능
- drag를 통해 지역을 다중선택할 수 있는
chart.dragAction:"select"기능이 추가되었습니다. - onSelectionChange 이벤트가 개선되었습니다.
- 다중 선택 상황에서 onSelectionChange 이벤트가 한번만 발생하도록 개선되었습니다.
- 툴팁이 개선되었습니다.
- 지도와 툴팁 간의 시각적 구분성을 향상시키기 위해 툴팁 UI를 개선했습니다.
tooltip.mode옵션을 통해 3가지 형태의 툴팁을 선택할 수 있도록 개선되었습니다.
- HTML 시리즈가 추가되었습니다.
- 사용자 정의 HTML 엘리먼트를 지도 위에 표시할 수 있는 HTML 시리즈가 추가되었습니다.
updateOption()API 기능이 개선되었습니다.- 자세한 내용은 아래의
updateOption API 개선 상세 안내섹션을 참고하세요.
- 자세한 내용은 아래의
updateOption API 개선 상세 안내
1. updateOption API의 기본 용도와 자식 모델
updateOption(propertyName, value) API는 원래 모델의 단일 속성 값을 변경하기 위한 함수입니다. (예: mapChart.title.updateOption('visible', false))
2. 개선된 사항: 객체(Object) 전달 지원
기존 방식의 한계:
이전에는 updateOption('자식모델이름', ...) 방식으로 자식 모델의 속성을 변경할 때, string, number 같은 **단순 값(Primitive value)**만 전달할 수 있었습니다. 여러 속성을 담은 객체를 한 번에 전달할 수는 없었습니다.
개선된 기능:
이제 updateOption('자식모델이름', 값)을 호출할 때, { visible: true, text: '...' }와 같이 여러 속성을 포함한 객체(Object)를 전달할 수 있도록 개선되었습니다.
3. 권장 사항
기능은 개선되었으나, 코드의 명확성과 일관성을 위해 자식 모델의 여러 속성을 변경할 때는 model.child.updateOptions({ ... }) 방식을 사용하시기를 권장합니다.
권장 방식 예제:
const mapSeries = mapChart.seriesByType('map');
// updateOption을 통한 자식 모델 속성 변경
mapSeries.updateOption('pointLabel', {
visible: true,
text: '${name}',
style: {
fontSize: '18px',
},
});
// 자식 모델을 통해 updateOptions으로 속성 변경 (권장 방식)
mapSeries.pointLabel.updateOptions({
visible: true,
text: '${name}',
style: {
fontSize: '18px',
},
});