Form
Form(폼) 위젯은 formId로 지정한 다른 폼(화면)을 불러와 그 자리에 끼워 넣는 컨테이너 위젯입니다.
화면 안에 재사용 가능한 폼을 중첩 배치하고, 부모-자식 폼 사이 메시지 통신을 연결할 때 사용합니다.
정의 / 역할
Form 위젯은 formId로 지정한 폼을 불러와 컨테이너 영역에 렌더링합니다. 담긴 폼은 독립된 컨텍스트를 가지므로, 부모에서 위젯에 직접 접근하지 않고 메시지로만 통신합니다. 스크립트에서 다른 폼을 다시 불러오거나(loadForm) 담긴 폼에 메시지를 보낼 수 있습니다(postMessage).
- 카테고리: Contents
- 기본
formId:""(불러올 폼이 지정되지 않은 상태로 생성) - 폼을 찾지 못하면
form not found안내가, 로드 중에는 로딩 표시가 나타납니다.
기능
| 기능 | 설명 |
|---|---|
| 폼 불러오기 | formId로 지정한 폼을 불러와 컨테이너 안에 렌더링합니다. |
| 폼 교체 | 스크립트에서 loadForm으로 담긴 폼을 다른 폼으로 바꿉니다. |
| 메시지 전달 | 스크립트에서 postMessage로 담긴 폼의 메시지 핸들러에 데이터를 보냅니다. |
| 로딩·빈 상태 표시 | 폼 로드 중에는 로딩 표시를, 폼을 찾지 못하면 안내 문구를 보여줍니다. |
| 분석 이벤트 | 담긴 폼의 화면 조회(view) 분석 이벤트 전송 여부를 설정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Form 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서
formId에 불러올 폼의 ID(경로)를 입력합니다. - 필요하면 담긴 폼과 데이터를 주고받도록 스크립트에서
postMessage를 연결합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
formId | 컨테이너에 불러올 폼의 ID(경로) | "" (미지정) | 문자열 |
analyticsView | 담긴 폼의 화면 조회(view) 분석 이벤트 전송 여부 | true (켜짐) | 참/거짓 |
주의 / 팁
노트
formId가 비어 있거나 존재하지 않는 폼을 가리키면 컨테이너에 form not found 안내만 표시됩니다. 불러올 폼의 ID를 정확히 지정해야 합니다.
팁
담긴 폼은 독립 컨텍스트라 부모에서 위젯에 직접 접근할 수 없습니다. 데이터 전달은 postMessage로, 다른 폼으로 교체는 loadForm으로 합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Form (폼) Widget Control 문서에서 확인하세요.