本文介紹其它特性的JSAPI,供您在建立H5端應用或者小程式時參考。
頁面載入完畢事件WindVaneReady
當頁面載入完畢後,WindVane會引發WindVaneReady事件,頁面可以監聽這一事件,擷取頁面載入狀態。頁面重新整理、頁面記錄回退同樣都會觸發這個事件。
document.addEventListener('WindVaneReady', function(e) {
alert('WindVaneReady');
}, false);
應用程式切換後台事件Background
當應用被切換到後台(如切換應用、開啟通知欄等操作)時,WindVane會引發WV.Event.APP.Background事件,頁面可以監聽這一事件,獲知應用已被切換到後台。
由於Android平台的限制,即使從當前WebView切換到其它Activity,也會引發WV.Event.APP.Background事件,而不僅僅是切換到後台時。
應用被切換到後台時能做的操作較少,可能會被延遲到頁面重新啟用時才執行。而且, 務必不要在該事件中彈alert,會導致一些Android機型出現嚴重BUG,開啟任何頁面都是空白。
WindVane iOS的5.6.0及更高版本,更新了Background事件的觸發條件,保持與Android 的一致:從當前 WebView切換到其它Native或WebView時也會觸發Background事件。
同時增加了一個事件參數to,用於區分從當前WebView切換到了何處,其取值為'background',表示從當前WebView切換到了後台。
如果to參數不存在,表示無法確定從當前WebView切換到了何處。
document.addEventListener('WV.Event.APP.Background', function(e) {
// 一些機型退出時彈 alert 會出問題。
console.log('Event Background');
}, false);
應用啟用事件Active
當應用被切換到後台再切換回來時,WindVane會引發WV.Event.APP.Active事件,頁面可以監聽這一事件,獲知應用已經被啟用。
由於Android平台的限制,即使從其它Activity切換到當前WebView,也會引發WV.Event.APP.Active事件,而不僅僅是從後台切換到前台時。
WindVane iOS的5.6.0及更高版本,更新了Active事件的觸發條件,保持與Android的一致:從其它Native或 WebView切換到當前WebView時也會觸發Active事件。
同時增加了一個事件參數from,用於區分從何處切換到當前WebView,其可能的值為:
'background':表示從後台切換到了當前WebView。'webview':表示從其它WebView切換到了當前WebView。
如果from參數不存在,表示無法確定從何處切換到當前WebView。
VER.WindVane 6.3.0及更高版本,添加了一個data參數,用來擷取從WebAppInterface.pop中傳遞的資料。
document.addEventListener('WV.Event.APP.Active', function(e) {
alert('Event Active');
}, false);