このトピックでは、H5 アプリとミニアプリを開発するための JSAPI の追加機能について説明します。
WindVaneReady イベント
WindVaneReady イベントは、ページのロードが完了した後にトリガーされます。このイベントをリッスンすることで、ページのロードステータスを監視できます。このイベントは、ページが更新されたときや、ページ履歴を戻ったときにもトリガーされます。
document.addEventListener('WindVaneReady', function(e) {
alert('WindVaneReady');
}, false);
Background イベント
別のアプリへの切り替えや通知バーの表示などによってアプリがバックグラウンドに移行すると、WindVane は WV.Event.APP.Background イベントをトリガーします。このイベントをリッスンすることで、アプリがいつバックグラウンドに入ったかを判断できます。
Android プラットフォームの制限により、このイベントは、アプリがバックグラウンドに移行したときだけでなく、現在の WebView から別の Activity に切り替えたときにもトリガーされます。
アプリがバックグラウンドにあるときに実行できる操作は制限されており、ページが再アクティブ化されるまで遅延する可能性があります。重要：このイベントハンドラーで alert() を呼び出さないでください。一部の Android デバイスで重大なバグが発生し、すべてのページが空白でロードされる原因となる可能性があります。
WindVane for iOS v5.6.0 以降では、Background イベントのトリガー条件が Android の動作と一致するように更新されました。このイベントは、現在の WebView から別のネイティブコンポーネントまたは WebView に切り替えたときにもトリガーされます。
このバージョンでは、現在の WebView からの切り替え先を指定するために、イベントパラメーター to が追加されています。値が 'background' の場合は、バックグラウンドへの切り替えを示します。
to パラメーターが存在しない場合、切り替え先を判断することはできません。
document.addEventListener('WV.Event.APP.Background', function(e) {
// 一部のデバイスでは、アプリがバックグラウンドに入るときに alert() を呼び出すと問題が発生します。
console.log('Event Background');
}, false);
Active イベント
アプリがバックグラウンドからフォアグラウンドに戻ると、WindVane は WV.Event.APP.Active イベントをトリガーします。このイベントをリッスンすることで、アプリがいつアクティブになったかを判断できます。
Android プラットフォームの制限により、このイベントは、アプリがバックグラウンドからフォアグラウンドに戻ったときだけでなく、別の Activity から現在の WebView に切り替えたときにもトリガーされます。
WindVane for iOS v5.6.0 以降では、Active イベントのトリガー条件が Android と一致するように更新されました。このイベントは、別のネイティブコンポーネントまたは WebView から現在の WebView に切り替えたときにもトリガーされます。
このバージョンでは、現在の WebView への切り替え元を示すために、イベントパラメーター from が追加されています。指定できる値は次のとおりです：
'background'：バックグラウンドからの復帰を示します。'webview'：別の WebView からの切り替えを示します。
from パラメーターが存在しない場合、切り替え元を判断することはできません。
WindVane v6.3.0 以降では、WebAppInterface.pop から渡されたデータを取得するために data パラメーターが追加されています。
document.addEventListener('WV.Event.APP.Active', function(e) {
alert('Event Active');
}, false);