on( eventName, callback )
| 引数 | 型 | 省略可能 | デフォルト値 | 説明 |
|---|---|---|---|---|
| eventName | String | false | - | 購読するイベント名 |
| callback | Function | false | - | イベント発生時に呼び出されるリスナーコールバック関数 |
エミッターインスタンス上のイベントを購読します。モダンな TypeScript Strelit UI Kit
では、レガシーな context
パラメーターを必要とせず、アロー関数または標準のクロージャバインディングを使用できます。
off( eventName, callback )
| 引数 | 型 | 省略可能 | デフォルト値 | 説明 |
|---|---|---|---|---|
| eventName | String | false | - | 購読を解除するイベント名 |
| callback | Function | false | - | 以前 |
イベントから指定されたリスナーを削除します。unbind は off
の後方互換用エイリアスとして維持されています。
emit( eventName, …args )
| 引数 | 型 | 省略可能 | デフォルト値 | 説明 |
|---|---|---|---|---|
| eventName | String | false | - | 発行するイベント名 |
| …args | any[] | 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);