본문으로 건너뛰기

Component (컴포넌트) Widget Control

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
getVarMethodcomponentID.getVar(name)컴포넌트가 외부에 노출한 변수 값을 읽음
setVarMethodcomponentID.setVar(name, value)읽기·쓰기(readwrite) 변수 값을 변경
onVarChangedEventcomponentID.onVarChanged = (name, value, prev) => { ... }노출된 변수가 바뀔 때 실행

Property​

정보

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

Method​

getVar​

컴포넌트가 외부에 노출한(readable · readwrite) 변수의 현재 값을 읽습니다. 존재하지 않는 이름이거나 비공개(private) 변수이면 null을 반환합니다.

  • 종류: Method
  • Parameters: name (문자열) - 읽을 변수 이름
  • Returns: 변수 값 (임의 타입). 알 수 없거나 비공개 변수이면 null

Example

const checked = componentID.getVar("checked");

setVar​

컴포넌트의 읽기·쓰기(readwrite) 변수 값을 변경합니다. 알 수 없거나, 비공개(private)이거나, 읽기 전용(readable) 변수이면 아무 동작도 하지 않습니다.

  • 종류: Method
  • Parameters: name (문자열) - 변수 이름 / value (임의 타입) - 새 값
  • Returns: 없음

Example

componentID.setVar("checked", true);

Event​

onVarChanged​

컴포넌트가 노출한 변수 중 하나라도 값이 바뀌면 실행됩니다. 핸들러는 바뀐 변수 이름·새 값·이전 값을 인자로 받습니다.

  • 종류: Event
  • 핸들러 인자: name(변수 이름) / value(새 값) / prev(이전 값)
  • Returns: 없음

Example

componentID.onVarChanged = (name, value, prev) => {
  if (name === "checked") {
    // 변경 시 실행할 코드
  }
};

공통 Widget Control (모든 위젯)​

노트

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