CustomWidget

CustomWidget(커스텀 위젯) 위젯은 앱의 네이티브 코드(SDK)에서 이 자리에 주입한 사용자 정의 위젯을 렌더링하는 자리입니다.
표준 위젯으로 표현하기 어려운 화면을 코드로 만들어 끼워 넣을 때 사용합니다.

정보

이 위젯은 Free 플랜에서 잠겨 있으며, Pro·Enterprise 플랜에서 사용할 수 있습니다.

정의 / 역할

CustomWidget 위젯은 앱 코드에서 지정한 사용자 정의 위젯이 들어갈 자리를 캔버스에 만들어 줍니다. 자리마다 위젯 id로 구분하며, 앱 코드에서 위젯이 지정되기 전에는 회색 테두리의 기본 자리 표시가 그려지고, 가운데에 Custom Widget 문구가 표시됩니다.

• 카테고리: Contents
• 기본 크기(SizedBox): 100 × 100
• 위젯 미지정 시 표시: 회색 테두리(모서리 둥근) 상자 + 가운데 Custom Widget 문구

기능

기능	설명
사용자 정의 위젯 배치	앱 코드에서 지정한 위젯을 캔버스의 이 자리에 렌더링합니다.
기본 자리 표시	위젯이 지정되기 전에는 회색 테두리 상자와 Custom Widget 문구가 표시됩니다.

사용 방법

1. 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
2. CustomWidget 항목을 캔버스로 끌어다 놓습니다.
3. 앱 코드에서 이 자리(위젯 id 기준)에 위젯을 지정하면 회색 자리 표시 대신 해당 위젯이 렌더링됩니다.

속성 (Property)

노트

CustomWidget 위젯에는 편집 패널에서 설정하는 전용 속성이 없습니다. 표시할 내용은 앱 코드에서 지정한 위젯이 결정합니다.

주의 / 팁

노트

앱 코드에서 위젯을 지정하기 전에는 회색 테두리 상자와 Custom Widget 문구만 표시됩니다. 실제 화면을 채우려면 앱 코드에서 위젯을 지정해야 합니다.

팁

팔레트에서 놓으면 기본 크기 100 × 100으로 배치됩니다. 크기는 배치 후 조정할 수 있습니다.

더 알아보기

팁

이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 CustomWidget (커스텀 위젯) Widget Control 문서에서 확인하세요.