API
MapSelection

MapSelection

맵차트의 데이터포인트 선택 목록.

데이터포인트의 선택 상태는 이 목록을 기준으로 한다. 목록을 바꾸는 메서드는 포인트의 선택 상태도 함께 바꾸고, 바뀐 것이 있으면 차트에 한 번만 알린다. 그래서 어떤 메서드로 몇 개를 바꾸든 onSelectionChanged는 호출 한 번에 한 번만 나간다.

목록은 선택한 순서를 유지하고 마지막 항목이 focus 포인트다(focusedPoint). 이미 선택된 포인트를 다시 선택하면 맨 뒤로 옮겨 focus가 된다. focus가 바뀌면 onSelectionChanged 뒤에 onFocusChanged가 한 번 나간다. #708

Properties

count: number (opens in a new tab) readonly

선택된 데이터포인트 개수.

default :undefined

first: ISelectionSource readonly

가장 먼저 선택된 데이터포인트. 선택이 없으면 undefined.

default :undefined

focusedPoint: ISelectionSource readonly

focus 포인트. 가장 마지막에 선택한 데이터포인트이고, 선택이 없으면 null이다. #708

chart.selection.focusedPoint?.id;

default :undefined

last: ISelectionSource readonly

가장 나중에 선택된 데이터포인트. 선택이 없으면 undefined이다. focusedPoint와 같은 포인트다.

default :undefined

Methods

add(series, list, clear?): boolean (opens in a new tab)

시리즈의 포인트들을 선택 목록에 더하고, 목록이나 focus가 바뀌었으면 true를 반환한다.

clear가 true면 list에 없는 기존 선택을 풀고 list의 포인트로 교체한다. 이미 선택된 포인트는 다시 넣지 않고 맨 뒤로 옮긴다. 결과는 "(남는 기존 선택) + (list 순서)"이고 list의 마지막 포인트가 focus다. 순서만 바뀌면 onSelectionChanged는 나가지 않고 onFocusChanged만 나간다. 순서만 바뀌고 focus도 그대로면 아무 알림 없이 true만 돌려준다. #708

ParameterType
seriesISeries<DataPoint>
listArray (opens in a new tab)<ISelectionSource>
clear=falseboolean (opens in a new tab)

addPoints(target): boolean (opens in a new tab)

id로 지정한 포인트들을 기존 선택에 더하고, 목록이나 focus가 바뀌었으면 true를 반환한다.

시리즈를 지정하지 않으면 화면에 보이는 선택 가능 시리즈 모두에서 같은 id를 고른다. 없는 시리즈·없는 id·선택할 수 없는 시리즈는 오류 없이 건너뛴다. 한 시리즈에 같은 id의 포인트가 여럿이면 첫 포인트만 고른다. 여러 시리즈·여러 포인트를 한 번에 더해도 onSelectionChanged는 한 번만 나간다. 이미 선택된 포인트는 맨 뒤로 옮겨지고, 지정한 순서의 마지막 포인트가 focus가 된다. #708

데이터포인트는 첫 렌더 때 만들어지므로 createChart·createChartAsync·load의 callback(LoadCallbackArgs를 받는 로드 콜백) 안에서 부른다. 그 전에는 고를 포인트가 없어 false를 돌려준다.

chart.selection.addPoints('11');                              // 모든 시리즈의 서울
chart.selection.addPoints(['11', '25']);                      // 여러 id
chart.selection.addPoints({ sido: ['11', '25'], sigun: '11230' });  // 시리즈별
ParameterType
targetSelectionTarget

clear(): boolean (opens in a new tab)

선택을 모두 해제하고, 해제한 것이 있으면 true를 반환한다.

contains(source): boolean (opens in a new tab)

데이터포인트가 선택되어 있는지 반환한다.

ParameterType
sourceISelectionSource

dispose(): null

객체를 해제하고 null을 반환한다.
사용 예: this._obj = this._obj.dispose();

return null

get(index): ISelectionSource

선택된 순서로 index번째 데이터포인트를 반환한다.

ParameterType
indexnumber (opens in a new tab)

remove(series, source): boolean (opens in a new tab)

시리즈의 포인트 하나를 선택 목록에서 빼고, 빠졌으면 true를 반환한다.

ParameterType
seriesISeries<DataPoint>
sourceISelectionSource

toggle(series, source): boolean (opens in a new tab)

데이터포인트의 선택 상태를 뒤집고, 바뀌었으면 true를 반환한다.

선택되어 있으면 해제하고, 아니면 기존 선택에 더한다.

ParameterType
seriesISeries<DataPoint>
sourceISelectionSource

unselectPoints(target): boolean (opens in a new tab)

id로 지정한 포인트들의 선택을 해제하고, 목록이 바뀌었으면 true를 반환한다.

대상 지정 방식은 addPoints와 같다. 전체 해제는 clear로 한다. 선택할 수 없게 된 시리즈의 포인트도 목록에 있으면 푼다.

chart.selection.unselectPoints({ sido: '11' });
ParameterType
targetSelectionTarget