event（イベント）

必要に応じて、事前にいくつかのコールバック関数を定義しておくことができます。Eagleはイベントが発生した際にそれらを自動的に呼び出します。

onPluginCreate(callback)

プラグインウィンドウが作成されたとき、Eagleはこのメソッドを自動的に呼び出します。このメソッドを使用して、プラグインが必要なモジュールを初期化できます。

• callback Function

  • plugin Object - プラグイン属性

    • manifest Object - プラグイン manifest.json の完全な設定。

    • path String - プラグインのパス

eagle.onPluginCreate((plugin) => {
    console.log(plugin.manifest.name);
    console.log(plugin.manifest.version);
    console.log(plugin.manifest.logo);
    console.log(plugin.path);
});

ヒント：プラグインが manifest 情報なしで実行できる場合、window.onload を使用して開発を進めることもできます。

onPluginRun(callback)

ユーザーがプラグインパネルのプラグインをクリックすると、Eagleはこのメソッドを自動的に呼び出します。

• callback Function

eagle.onPluginRun(() => {
    console.log('eagle.onPluginRun');
});

onPluginBeforeExit(callback)

プラグインウィンドウが閉じる前に、Eagleはこのメソッドを自動的に呼び出します。

• callback Function

eagle.onPluginBeforeExit(() => {
    console.log("プラグインが終了します");
});

// ウィンドウのクローズを阻止
window.onbeforeunload = (event) => {
    return event.returnValue = false;
};

ヒント：ウィンドウのクローズを防ぎたい場合は、window.onbeforeunload メソッドを登録してウィンドウが閉じられないようにできます。

onPluginShow(callback)

プラグインウィンドウが表示されるとき、Eagleはこのメソッドを自動的に呼び出します。

• callback Function

eagle.onPluginShow(() => {
    console.log("プラグインウィンドウが表示されました");
});

onPluginHide(callback)

プラグインウィンドウが隠れるとき、Eagleはこのメソッドを自動的に呼び出します。

• callback Function

eagle.onPluginHide(() => {
    console.log("プラグインウィンドウが隠れました");
});

onLibraryChanged(callback)

ユーザーがリソースライブラリを切り替えると、Eagleはこのメソッドを自動的に呼び出します。

• callback Function

  • libraryPath String - 現在のリソースライブラリのパス。

eagle.onLibraryChanged((libraryPath) => {
    console.log(`リソースライブラリの切り替えが検出されました。新しいリソースライブラリのパス: ${libraryPath}`);
});

ヒント：より完全なリソースライブラリ情報が必要な場合は、eagle.library.info() メソッドを使用できます。

注意： プラグインの実行過程で相対的なリソースライブラリパスに依存する場合、この方法を登録してリソースライブラリが切り替えられたときに対応する調整を行い、プログラムの実行過程でエラーが発生しないようにする必要があります。

onThemeChanged(callback)

Eagle メインプログラムのテーマカラーが変更されると、Eagle はこのメソッドを自動的に呼び出します。プラグインが複数のカラーテーマに対応している場合、このメソッドを使用して対応する UI の調整を行うことができます。

• callback 関数

  • theme String - 現在のテーマカラーの名前。Auto、LIGHT、LIGHTGRAY、GRAY、DARK、BLUE、PURPLE など。

eagle.onThemeChanged((theme) => {
    console.log(`配色テーマが次のように変更されました: ${theme}`);
});