Echart (Echart) Widget Control

Echart(Echart) 위젯을 스크립트에서 제어할 때 사용하는 Widget Control(Method) 목록입니다. 위젯 소개와 사용법은 Echart 문서를 참고하세요.

정보

아래 예시의 echartID는 캔버스에서 Echart 위젯에 지정한 이름(ID)입니다. 스크립트에서는 위젯ID.멤버 형태로 접근합니다.

Widget Control 요약

Widget Control	종류	시그니처	설명
setVar	Method	setVar(name, value)	차트 변수 하나의 값을 설정(교체)
setOption	Method	setOption(optionJson)	차트 옵션(ECharts option) 전체를 교체
setOptionPartial	Method	setOptionPartial(optionJson)	차트 옵션에 부분 병합(변경 키만 갱신)
dispatchAction	Method	dispatchAction(actionJson)	차트에 ECharts 액션 전달(highlight 등)

Property

정보

해당 없음 - Echart 위젯에는 스크립트 전용 Property가 없습니다. 스크립트에서는 아래 공통 Widget Control(getProperty / setProperty)로 값을 읽고 씁니다.

Method

setVar

차트 변수 하나의 값을 설정합니다. 같은 이름에 바인딩된 기존 값을 교체합니다. 차트 로딩이 끝나기 전에 호출해도 값이 캐시되어 차트 첫 렌더링에 반영됩니다.

• 종류: Method
• Parameters:
  • name (문자열): 옵션 템플릿이 참조하는 변수 이름
  • value (문자열): 변수 값. JSON 문자열로 전달하며 전송 전 파싱됩니다 (배열·객체·원시값)
• Returns: 없음 (반환값 없음)

Example

echartID.setVar("series1", [120, 200, 150]);

setOption

차트 옵션(ECharts option) 전체를 주어진 JSON으로 교체합니다. 컴포넌트에 설정된 옵션 템플릿을 덮어씁니다.

• 종류: Method
• Parameters:
  • optionJson (객체): 완전한 ECharts option 객체
• Returns: 없음 (반환값 없음)

Example

echartID.setOption({
  xAxis: { type: "category", data: ["Mon", "Tue", "Wed"] },
  yAxis: { type: "value" },
  series: [{ type: "bar", data: [120, 200, 150] }]
});

setOptionPartial

주어진 JSON을 현재 차트 옵션에 병합합니다(전체 교체하지 않음). optionJson에 있는 키만 갱신되고 나머지는 그대로 유지됩니다. 부분(증분) 업데이트에 사용합니다.

• 종류: Method
• Parameters:
  • optionJson (객체): 병합할 부분 ECharts option 객체
• Returns: 없음 (반환값 없음)

Example

echartID.setOptionPartial({
  series: [{ data: [130, 210, 160] }]
});

dispatchAction

차트에 ECharts 액션(예: highlight, showTip)을 전달합니다. 차트 초기화가 끝나기 전에는 아무 동작도 하지 않습니다.

• 종류: Method
• Parameters:
  • actionJson (객체): ECharts 액션 페이로드 객체
• Returns: 없음 (반환값 없음)

Example

echartID.dispatchAction({ type: "highlight", seriesIndex: 0, dataIndex: 2 });

Event

정보

해당 없음 - Echart 위젯에는 전용 Event가 없습니다.

공통 Widget Control (모든 위젯)

노트

모든 위젯은 setProperty / getProperty / setStyleProperty 같은 이름 기반 공통 Widget Control(Method)을 사용할 수 있습니다. 공통 레퍼런스 문서(작성 예정)를 참고하세요.