본문으로 건너뛰기

MasonryGrid (메이슨리그리드) Widget Control

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
countPropertymasonrygridID.count (get/set int)반복 항목 개수를 읽거나 설정
currentPropertymasonrygridID.current (get/set int)바인딩 스코프로 쓸 현재 항목 인덱스
selectPropertymasonrygridID.select (get/set int)선택된 항목 인덱스
addMethodmasonrygridID.add()맨 끝에 항목 추가 (추가된 인덱스 반환)
insertMethodmasonrygridID.insert(index)지정 위치에 항목 삽입
removeMethodmasonrygridID.remove(index)지정 인덱스 항목 제거
clearMethodmasonrygridID.clear()전체 항목 제거
setStateMethodmasonrygridID.setState(index, function)특정 항목만 갱신
onSelectedEventmasonrygridID.onSelected = (index) => { ... }항목을 탭했을 때 실행

Property​

count​

반복되는 항목의 개수입니다. 값을 쓰면 바인딩된 데이터 목록이 그 수에 맞춰 늘거나 줄고 다시 그려집니다. 읽으면 현재 항목 개수를 반환합니다.

  • 종류: Property (읽기/쓰기)
  • 타입: int
  • 읽기: 현재 반복 항목 개수 반환
  • 쓰기: 항목 개수를 지정한 값으로 맞춤

Example

masonrygridID.count = 10;
const n = masonrygridID.count;

current​

바인딩 스코프로 사용할 현재 항목 인덱스입니다. 이후의 속성 쓰기는 이 항목의 행을 대상으로 합니다.

  • 종류: Property (읽기/쓰기)
  • 타입: int
  • 읽기: 현재 항목 인덱스 반환 (설정된 값이 없으면 -1)
  • 쓰기: 바인딩 스코프로 쓸 항목 인덱스 지정

Example

masonrygridID.current = 0;

select​

선택된 항목 인덱스입니다.

  • 종류: Property (읽기/쓰기)
  • 타입: int
  • 읽기: 선택된 항목 인덱스 반환 (선택 없으면 -1)
  • 쓰기: 선택할 항목 인덱스 지정

Example

masonrygridID.select = 2;

Method​

add​

맨 끝에 빈 항목을 추가하고 다시 그립니다.

  • Parameters: 없음
  • Returns: int - 새로 추가된 항목의 인덱스

Example

const i = masonrygridID.add();

insert​

지정한 인덱스에 빈 항목을 삽입하고 다시 그립니다.

  • Parameters: index (int) - 삽입할 위치
  • Returns: 없음

Example

masonrygridID.insert(0);

remove​

지정한 인덱스의 항목을 제거하고 다시 그립니다. 인덱스가 범위를 벗어나면 아무 동작도 하지 않습니다.

  • Parameters: index (int) - 제거할 항목 인덱스
  • Returns: 없음

Example

masonrygridID.remove(0);

clear​

모든 항목을 제거하고 다시 그립니다.

  • Parameters: 없음
  • Returns: 없음

Example

masonrygridID.clear();

setState​

지정한 인덱스를 바인딩 스코프로 설정한 채 콜백을 실행한 뒤 해당 항목만 다시 그립니다. 한 항목의 바인딩 속성만 갱신할 때 사용합니다.

  • Parameters: index (int) - 갱신할 항목 인덱스 / function (콜백 함수) - 해당 인덱스가 활성인 동안 실행할 콜백
  • Returns: 없음

Example

masonrygridID.setState(0, () => {
  // 항목 0의 바인딩 속성 갱신
});

Event​

onSelected​

사용자가 항목을 탭했을 때 실행됩니다.

  • 종류: Event
  • 핸들러 인자: index - 탭한 항목의 인덱스
  • Returns: 없음

Example

masonrygridID.onSelected = (index) => {
  // 탭한 항목 index 처리
};

공통 Widget Control (모든 위젯)​

노트

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