Component
Component(컴포넌트) 위젯은 따로 만든 컴포넌트 마스터를 화면에 끼워 넣는 인스턴스입니다. 한 번 만든 컴포넌트를 여러 곳에서 반복 사용하고, 마스터를 수정하면 모든 인스턴스에 반영됩니다.
정보
이 위젯은 Free 플랜에서 잠겨 있으며, Pro·Enterprise 플랜에서 사용할 수 있습니다.
정의 / 역할
Component 위젯은 미리 제작한 컴포넌트 마스터의 복제본(인스턴스)을 그려줍니다. 인스턴스는 마스터의 위젯 구성을 그대로 따르되, 인스턴스별로 속성을 덮어쓰거나(override) 변수 초기값을 다르게 지정할 수 있습니다.
- 카테고리: Contents
- 참조 대상: 컴포넌트 마스터 (
id로 지정)
기능
| 기능 | 설명 |
|---|---|
| 컴포넌트 인스턴스화 | 미리 만든 컴포넌트 마스터를 화면에 배치합니다. 마스터가 수정되면 인스턴스가 자동으로 갱신됩니다. |
| 속성 덮어쓰기 | 인스턴스별로 내부 위젯의 속성을 덮어써(override) 다르게 표시할 수 있습니다. 되돌리면 마스터 값을 따릅니다. |
| 변수 초기값 | 인스턴스마다 컴포넌트 변수의 초기값을 다르게 지정할 수 있습니다. |
| 변수 노출·연동 | 컴포넌트가 외부에 노출한 변수를 스크립트에서 읽고 쓰며, 값이 바뀔 때 이벤트로 알립니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Component 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 표시할 컴포넌트 마스터를 선택합니다(
id). - 필요하면 인스턴스별 속성 덮어쓰기·변수 초기값을 조정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
id | 표시할 컴포넌트 마스터의 식별자 | 빈 값 (컴포넌트 미선택) | 문자열 (컴포넌트 마스터 ID) |
주의 / 팁
노트
Component 위젯은 표시할 컴포넌트 마스터(id)를 지정해야 화면에 나타납니다. 지정하지 않으면 아무것도 그려지지 않습니다.
경고
컴포넌트가 자기 자신을 직접·간접적으로 포함하면(순환 참조) 해당 인스턴스는 그려지지 않고 오류 표시가 나타납니다. 중첩 깊이에도 제한이 있습니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Component (컴포넌트) Widget Control 문서에서 확인하세요.