全部产品
Search
文档中心

SuperApp:其它特性

更新时间:Jun 09, 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);