가이드
릴리즈
v1.1.1

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',
    },
});