본문으로 건너뛰기

Slider (슬라이더) Widget Control

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
onChangedEventonChanged = (value) => { ... }손잡이를 드래그해 값이 바뀔 때 실행
onChangeStartEventonChangeStart = (value) => { ... }드래그를 시작할 때 실행 - 현재 버전에서는 지원하지 않습니다.
onChangeEndEventonChangeEnd = (value) => { ... }드래그를 끝낼 때 실행 - 현재 버전에서는 지원하지 않습니다.

Property​

정보

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

Method​

정보

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

Event​

onChanged​

손잡이를 드래그해 슬라이더 값이 바뀔 때 연속적으로 실행됩니다. 실행할 동작을 콜백 함수로 지정합니다.

  • 종류: Event
  • Parameters: value - 새 슬라이더 값 (min~max 사이의 숫자)
  • Returns: 없음

Example

sliderID.onChanged = (value) => {
  // value: 새 슬라이더 값
  console.log(value);
};

onChangeStart​

손잡이 드래그를 시작할 때 실행하려는 동작을 콜백으로 지정합니다.

  • 종류: Event
  • Parameters: value - 드래그 시작 시점의 슬라이더 값
  • Returns: 없음
경고

현재 버전에서는 지원하지 않습니다(추후 업데이트 예정). 스튜디오 Event 목록에는 노출되지만, 현재 버전에서는 지정한 콜백이 실행되지 않습니다. 드래그 중 값 변화는 onChanged로 처리하세요.

onChangeEnd​

손잡이 드래그를 끝낼 때 실행하려는 동작을 콜백으로 지정합니다.

  • 종류: Event
  • Parameters: value - 드래그 종료 시점의 슬라이더 값
  • Returns: 없음
경고

현재 버전에서는 지원하지 않습니다(추후 업데이트 예정). 스튜디오 Event 목록에는 노출되지만, 현재 버전에서는 지정한 콜백이 실행되지 않습니다.

공통 Widget Control (모든 위젯)​

노트

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