TIP
このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください
カスタムインタラクションイベント
イベントエディターでJavaScriptを記述し、EChartsインスタンスのchartを通じてインタラクションを登録することで、連携を実現できます。例えば、新しいページへの遷移や、ドリルダウン分析用のダイアログを開くといった操作が可能です。
イベントの登録と解除
- 登録：
chart.on(eventName, handler) - 解除：
chart.off(eventName, handler)またはchart.off(eventName)で同名のイベントをクリアします。
注意： 安全上の理由から、イベントを登録する前に必ず解除することをお勧めします！
ハンドラー関数の引数 params のデータ構造
よく使われるものとして、params.data や params.name などがあります。
例：クリックで選択をハイライト表示
例：クリックでページに遷移
例：クリックで詳細ダイアログを表示（ドリルダウン分析）
新しく開いたダイアログでは、チャートで宣言されたコンテキスト変数 ctx.view.inputArgs.XXX を使用します。
プレビューと保存
- 「プレビュー」をクリックすると、イベントコードが読み込まれて実行されます。
- 「保存」をクリックすると、現在のイベント設定が保存されます。
- 「キャンセル」をクリックすると、最後に保存された状態に戻ります。
推奨事項：
- 複数回のバインドによる重複実行やメモリ増加を防ぐため、バインドする前に必ず
chart.off('event')を使用してください。 - イベントハンドラー内では、レンダリングのブロックを避けるため、
dispatchActionやsetOptionのような軽量な操作をできるだけ使用してください。 - イベント処理で扱うフィールドが現在のデータと一致していることを確認するため、チャートオプションやデータクエリと連携して検証してください。