NestedScroll (중첩 스크롤) Widget Control

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

정보

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

Widget Control 요약

Widget Control	종류	시그니처	설명
scrollToMax	Method	scrollToMax(duration?)	맨 아래(뒤쪽 고정 헤더 직전)까지 스크롤
scrollToTop	Method	scrollToTop(duration?)	맨 위로 스크롤
onStartScroll	Event	onStartScroll = (isVertical, position) => { ... }	스크롤이 시작될 때 실행
onUpdateScroll	Event	onUpdateScroll = (isVertical, position) => { ... }	스크롤하는 동안 계속 실행
onStopScroll	Event	onStopScroll = (isVertical, position) => { ... }	스크롤이 멈출 때 실행
onScrollEnd	Event	onScrollEnd = (isVertical) => { ... }	콘텐츠 끝(바닥)에 도달했을 때 실행

Property

정보

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

Method

scrollToMax

뷰의 맨 아래까지 스크롤합니다. 뒤쪽에 연속으로 붙은 고정(pinned) 헤더가 있으면 그 직전까지만 이동하고, 안쪽 스크롤 위치는 맨 위로 초기화합니다.

• 종류: Method
• Parameters: duration (숫자, 선택) - 애니메이션 시간(밀리초). 기본값 300. 0 이하이면 애니메이션 없이 즉시 이동합니다.
• Returns: 없음(void)

Example

nestedscrollID.scrollToMax(300);

scrollToTop

뷰의 맨 위로 스크롤합니다.

• 종류: Method
• Parameters: duration (숫자, 선택) - 애니메이션 시간(밀리초). 기본값 300. 0 이하이면 애니메이션 없이 즉시 이동합니다.
• Returns: 없음(void)

Example

nestedscrollID.scrollToTop(300);

Event

onStartScroll

스크롤이 시작될 때 실행됩니다.

• 종류: Event
• Parameters: isVertical (참/거짓) - 스크롤 축이 세로이면 true. position (숫자) - 현재 스크롤 위치(픽셀).
• Returns: 없음

Example

nestedscrollID.onStartScroll = (isVertical, position) => {
  // 스크롤 시작 시 실행할 코드
};

onUpdateScroll

스크롤하는 동안 연속으로 실행됩니다.

• 종류: Event
• Parameters: isVertical (참/거짓) - 세로 축이면 true. position (숫자) - 현재 스크롤 위치(픽셀).
• Returns: 없음

Example

nestedscrollID.onUpdateScroll = (isVertical, position) => {
  // 스크롤 중 실행할 코드
};

onStopScroll

스크롤이 멈출 때 실행됩니다.

• 종류: Event
• Parameters: isVertical (참/거짓) - 세로 축이면 true. position (숫자) - 현재 스크롤 위치(픽셀).
• Returns: 없음

Example

nestedscrollID.onStopScroll = (isVertical, position) => {
  // 스크롤 정지 시 실행할 코드
};

onScrollEnd

스크롤이 콘텐츠의 끝(바닥)에 도달했을 때 한 번 실행됩니다. 바닥에서 벗어난 뒤 다시 도달하면 재실행됩니다.

• 종류: Event
• Parameters: isVertical (참/거짓) - 세로 축이면 true.
• Returns: 없음

Example

nestedscrollID.onScrollEnd = (isVertical) => {
  // 바닥 도달 시 실행할 코드
};

공통 Widget Control (모든 위젯)

노트

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