onMessage
onMessage
他のフォームから送られたメッセージを受信したときに呼び出されます。
パラメータ
name(string): メッセージ名data(dynamic): メッセージとともに渡された値
戻り値: 戻り値なし — コールバック関数のため、戻り値は使用されません。
説明
他のフォーム(ページ、ポップアップなど)からメッセージが送られると、この関数が呼び出され、受信側でその内容を処理できます。フォーム間でデータを直接連携(バインディング)せず、イベントとして値をやり取りするときに使用します。
Example
function onMessage(name, data) {
if (name === "refresh") {
$vm.requestData("mainList");
}
}
関連と注意事項
- 送信側がどの名前(
name)を使うかは別途取り決めておく必要があります。名前そのものを強制する仕組みはありません。 - 1つの値を継続的に同期したい場合は、メッセージよりもVariableやウィジェットプロパティのバインディングのほうが適しています。
onMessageは「イベントが発生した」ことを一度だけ通知する用途に近いものです。