postMessage
postMessage
이 폼 또는 자식 폼에 메시지를 전송합니다. 수신 폼의 onMessage 핸들러가 호출됩니다.
파라미터
name(string):onMessage핸들러로 라우팅되는 메시지 이름data(any): 핸들러에 전달되는 페이로드 (null 가능)target(string, 선택): 전달 대상- null 또는 빈 문자열 → 자기 자신
- FormContainer 이름 → 해당 자식 폼
- 쉼표로 구분 → 여러 자식 폼 동시 전달
'*'→ 자신 + 모든 임베드 폼에 브로드캐스트
반환: 없음 (void)
postMessage vs postMessageAll vs postDelayedMessage vs postMessageToApp 비교
| 메서드 | 전달 범위 | 지연 |
|---|---|---|
postMessage | 자기 자신 또는 지정한 자식(들) | 없음 |
postMessageAll | 자신 + 모든 자식 폼 (재귀) | 없음 |
postDelayedMessage | postMessage와 동일 | 지정한 밀리초 후 |
postMessageToApp | 앱 레벨 (KAppManager) | 0 또는 지정 밀리초 |
Example
// 자기 자신에게 메시지
$form.postMessage("refresh", null, null);
// 특정 자식 폼에 전달
$form.postMessage("updateStock", { code: "005930" }, "stockChart");
// 여러 자식에 동시 전달
$form.postMessage("resetAll", null, "panel1,panel2");
// 자신 + 모든 임베드 폼에 브로드캐스트
$form.postMessage("themeChanged", { dark: true }, "*");
관련
$form.postMessageAll(name, data)— 자신 + 모든 자식에 재귀 전송$form.postDelayedMessage(name, data, target, milliSeconds)— 지연 후 전송$form.postMessageToApp(name, data, milliSeconds)— 앱 레벨 메시지