Appearance
기능 빌더
기능 빌더로 화면을 구성하고 위젯을 배치하는 방법을 안내합니다. 구조·데이터·저장에 대한 요약은 앱 문서: 기능 빌더 요약을 참고하세요.
개요
- 캔버스: 툴킷에서 위젯을 드래그해 그리드에 배치합니다.
- 설정 패널: 선택한 위젯의 스타일·콘텐츠, 데이터 소스를 설정합니다.
- 미리보기: 캔버스와 실제 기능 페이지(/feature/카테고리ID)에서 변경 사항을 확인합니다.
위젯
툴킷에서 드래그해 배치할 수 있는 위젯입니다. 위젯 선택 시 오른쪽 설정 패널에서 라벨·스타일·데이터 소스를 설정할 수 있습니다.
기본 위젯 (툴킷과 동일 순서)
툴킷 기본 요소에 표시되는 위젯입니다. 이름·설명은 앱의 위젯 툴킷과 동일합니다.
| 위젯 | No. | 설명 | 최소 크기 |
|---|---|---|---|
| 버튼 | 1 | 액션, 링크 | 2×1 |
| 메뉴 | 2 | 드롭다운 메뉴 | 2×1 |
| 다이얼로그 | 3 | 모달 대화상자 | 2×1 |
| 체크박스 | 4 | 선택/해제 토글 | 2×1 |
| 콤보박스 | 5 | 선택 또는 직접 입력 | 2×1 |
| 텍스트 필드 | 6 | 한 줄 입력 | 2×1 |
| 텍스트 영역 | 7 | 여러 줄 입력 | 2×2 |
| 이미지 | 8 | 이미지 표시 | 2×2 |
| 아이콘 | 9 | 단일 아이콘 (MDI) | 1×1 |
| 라디오 버튼 | 10 | 단일 선택 | 2×1 |
위젯 간 이벤트(동작 연결)
특정 위젯의 이벤트(클릭, 값 변경 등)가 발생했을 때 다른 위젯의 값이나 상태를 바꾸는 규칙을 빌더에서 설정할 수 있습니다. 코드 없이 "버튼을 누르면 텍스트 필드에 문구 넣기", "체크 시 다이얼로그 열기" 같은 동작을 구성할 수 있습니다.
이벤트 소스 (트리거)
설정 패널에서 이벤트 시 동작 섹션이 표시되는 위젯입니다.
| 위젯 | 이벤트 | 설정 패널 섹션 |
|---|---|---|
| 버튼 | 클릭 | 클릭 시 동작 |
| 체크박스 | 체크/해제 | 변경 시 동작 |
| 라디오 버튼 | 선택 변경 | 변경 시 동작 |
| 콤보박스 | 항목 선택 | 변경 시 동작 |
동작 대상 (타겟)
이벤트 발생 시 설정할 수 있는 위젯과 속성입니다.
| 위젯 | 속성 | 설정 예 |
|---|---|---|
| 텍스트 필드 | 값 | 입력할 문자열 |
| 이미지 | 이미지 URL | 표시할 이미지 주소 |
| 라디오 버튼 | 선택값 | 특정 값으로 선택 / 다른 항목으로 변경 |
| 다이얼로그 | 열기/닫기 | 열기 / 닫기 |
사용 방법
- 캔버스에서 이벤트 소스가 될 위젯(예: 버튼)을 선택합니다.
- 오른쪽 설정 패널에서 클릭 시 동작 또는 변경 시 동작 영역의 동작 추가를 누릅니다.
- 대상 위젯으로 텍스트 필드·이미지·라디오·다이얼로그 중 하나를 고릅니다.
- 대상 타입에 맞게 값(문자열, URL, 선택값, 열기/닫기)을 입력합니다.
- 필요하면 동작을 더 추가한 뒤 저장합니다.
동적 기능 페이지(/feature/카테고리ID)에서 해당 이벤트가 발생하면 설정한 대로 다른 위젯이 갱신됩니다. 페이지를 떠났다 다시 들어오면 이벤트로 바꿨던 값은 초기화됩니다.