全部產品
Search
文件中心

SuperApp:其它特性

更新時間:Jun 10, 2025

本文介紹其它特性的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);