본문으로 건너뛰기

DropDown (드롭다운) Widget Control

정보

예제 파일: 07_Work_with_Widgets/dropdown_objet.lfp

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
valuePropertystring (읽기/쓰기)선택된 항목의 값
itemsProperty배열 (쓰기 전용)선택 항목 목록 설정
onChangedEventonChanged = (value) => { ... }다른 항목을 선택했을 때 실행

Property​

value​

현재 선택된 항목의 값입니다. 쓰기 시 기본 선택값을 지정하며(항목의 value 중 하나와 일치해야 함), 읽기 시 현재 선택된 항목의 값을 반환합니다.

  • 타입: string
  • 접근: 읽기 / 쓰기

Example

// 기본 선택값 지정
dropdownID.value = "ko";

// 현재 선택값 읽기
const selected = dropdownID.value;

items​

쓰기 전용으로, 선택할 수 있는 항목 목록을 설정합니다. 각 항목은 title(표시 텍스트), 선택적 subtitle, value를 가집니다. value를 생략하면 title이 값으로 쓰입니다.

  • 타입: 배열 [{ title, subtitle?, value? }]
  • 접근: 쓰기 전용

Example

dropdownID.items = [
  { title: "Korean", subtitle: "한국어", value: "ko" },
  { title: "English", value: "en" },
];

Method​

정보

해당 없음 - DropDown 위젯에는 전용 Method가 없습니다. 아래 공통 Widget Control을 사용합니다.

Event​

onChanged​

사용자가 다른 항목을 선택했을 때 실행됩니다.

  • 종류: Event
  • 핸들러 인자
    • value: 선택된 항목의 value
  • Returns: 없음

Example

//사용자가 드롭다운에서 다른 항목을 선택했을 시
dropdownID.onChanged = (value) => {
  // value: 선택된 항목의 값
};

공통 Widget Control (모든 위젯)​

노트

모든 위젯은 setProperty(name, value) / getProperty(name) / setStyleProperty(styleName, styleProperty, value) 같은 공통 Widget Control(Method)도 사용할 수 있습니다. 자세한 규칙은 공통 Widget Control 레퍼런스를 참고하세요.