본문으로 건너뛰기

postMessage

postMessage

이 폼 또는 자식 폼에 메시지를 전송합니다. 수신 폼의 onMessage 핸들러가 호출됩니다.

파라미터

  • name (string): onMessage 핸들러로 라우팅되는 메시지 이름
  • data (any): 핸들러에 전달되는 페이로드 (null 가능)
  • target (string, 선택): 전달 대상
    • null 또는 빈 문자열 → 자기 자신
    • FormContainer 이름 → 해당 자식 폼
    • 쉼표로 구분 → 여러 자식 폼 동시 전달
    • '*' → 자신 + 모든 임베드 폼에 브로드캐스트

반환: 없음 (void)

postMessage vs postMessageAll vs postDelayedMessage vs postMessageToApp 비교

메서드전달 범위지연
postMessage자기 자신 또는 지정한 자식(들)없음
postMessageAll자신 + 모든 자식 폼 (재귀)없음
postDelayedMessagepostMessage와 동일지정한 밀리초 후
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) — 앱 레벨 메시지