📖ドキュメント一覧▼

EventEmitter とシグナル (EventEmitter & Signals)

on( eventName, callback )

引数型省略可能デフォルト値説明
eventNameStringfalse-購読するイベント名
callbackFunctionfalse-イベント発生時に呼び出されるリスナーコールバック関数

エミッターインスタンス上のイベントを購読します。モダンな TypeScript Strelit UI Kit では、レガシーな context パラメーターを必要とせず、アロー関数または標準のクロージャバインディングを使用できます。

off( eventName, callback )

引数型省略可能デフォルト値説明
eventNameStringfalse-購読を解除するイベント名
callbackFunctionfalse-

以前 on() で登録された特定のコールバックリスナー

イベントから指定されたリスナーを削除します。unbind は off の後方互換用エイリアスとして維持されています。

emit( eventName, …args )

引数型省略可能デフォルト値説明
eventNameStringfalse-発行するイベント名
…argsany[]true-リスナーに渡される引数

リスナーにイベントを通知し、引数を渡します。trigger は emit のエイリアスです。

addEventListener( eventName, callback ) & removeEventListener( eventName, callback )

on() および off() の標準 Web 準拠エイリアスです。

emitBaseBubblingEvent( eventName )

レイアウトツリーを上位へ伝播(バブリング)する階層イベントを発行します(ComponentItem から親の Stack、RowOrColumn 、そしてルートレイアウトへ)。受信コールバックには EventEmitterBubblingEvent インスタンスが渡されます:

  • event.name: イベントの文字列名。

  • event.target: バブリングイベントを開始した元の EventEmitter。

  • event.stopPropagation(): レイアウトツリー階層の上位への更なるバブリングを停止します。

  • event.isPropagationStopped: 伝播が停止されたかどうかを示す真偽値。

EventHub とマルチウィンドウ間同期 (Multi-Window Sync)

各 StrelitLayout インスタンスは、すべての分離されたポップアウトウィンドウ( BrowserPopout インスタンス)とメインウィンドウ間でメッセージ受け渡しを容易にする EventHub(layout.eventHub 経由でアクセス可能)を管理します:

// すべての分離ウィンドウおよびメインレイアウトにカスタムメッセージを一斉送信
layout.eventHub.emitUserBroadcast('tickerUpdated', { symbol: 'AAPL', price: 185.5 });

// アプリケーション内の任意の場所でブロードキャストメッセージを受信
const handleBroadcast = (data) => {
  console.log('マルチウィンドウイベントを受信:', data);
};
layout.eventHub.on('userBroadcast', handleBroadcast);

// コンポーネントのアンマウント時に購読解除
layout.eventHub.off('userBroadcast', handleBroadcast);

マルチ画面トレーディング端末やエンタープライズ分析ダッシュボードの構築、レガシーレイアウトからの移行など、チームとコミュニティがサポートします。

GitHub で Issue を作成 →