mui开发app之webview
若将app理解为浏览器,那么webview相当于tab标签,app页面间的切换,也就是webview的切换。
在Html5plus的官方文档中关于webview的方法并不多,共有如下几个
all 获取所有webview窗口
close 关闭webview窗口
create 创建新的webview窗口
currentWebview 获取当前窗口的webviewObject对象(这个对象很重要!!)
getWebviewById 查找指定表示的webviewObject窗口
hide 隐藏webview窗口
open 创建并打开webview窗口
show 显示webview窗口
1.获取当前窗口id
//WebviewObject plus.webview.currentWebview(); var ws=plus.webview.currentWebview();//获取当前页面所属的Webview窗口对象 console.log( "窗口标识: "+ws.id ); console.log( "当前Webview窗口:"+ws.getURL() );
2.通过id获取对象关闭窗口(查找指定标识的WebviewObject窗口)
var ws = plus.webview.getWebviewById(id); plus.webview.close(ws); 等效于:plus.webview.getWebviewById(id).close(); var h=plus.webview.getWebviewById( plus.runtime.appid ); console.log( "应用首页Webview窗口:"+h.getURL() );
3.获取所有Webview窗口
// Array[WebviewObject] plus.webview.all(); // 获取所有Webview窗口 var wvs=plus.webview.all(); for(var i=0;i<wvs.length;i++){ console.log('webview'+i+': '+wvs[i].getURL()); }
4.关闭Webview窗口
//void plus.webview.close( id_wvobj, aniClose, duration, extras ); var ws=plus.webview.currentWebview(); plus.webview.close(ws);
5.创建新的Webview窗口
//WebviewObject plus.webview.create( url, id, styles, extras ); var w = plus.webview.create('http://m.weibo.cn/u/3196963860'); w.show(); // 显示窗口
//参数extras: ( JSON ) 可选 创建Webview窗口的额外扩展参数值为JSON类型,设置扩展参数后可以直接通过Webview的点(“.”)操作符获取扩展参数属性值,
//如: var w=plus.webview.create(‘url.html’,’id’,{},{preload:’preload webview’});
// 可直接通过以下方法获取preload值 console.log(w.preload);
// 输出值为“preload webview”
6.获取屏幕所有可视的Webview窗口
说明:仅在屏幕区域显示的Webview窗口,如果Webview窗口显示了但被其它Webview窗口盖住则认为不可视。 // Array[WebviewObject] plus.webview.getDisplayWebview(); // 获取所有可视的Webview窗口 var wvs=plus.webview.getDisplayWebview(); for(var i=0;i<wvs.length;i++){ console.log('Display webview '+i+': '+wvs[i].getURL()); }
7.获取应用首页WebviewObject窗口对象
//WebviewObject plus.webview.getLaunchWebview(); // 获取应用首页窗口对象 var h=plus.webview.getLaunchWebview(); console.log('应用首页Webview窗口:'+h.getURL());
8.获取应用第二个首页WebviewObject窗口对象
//WebviewObject plus.webview.getSecondWebview(); var h=plus.webview.getSecondWebview(); if(h){ console.log('应用第二个首页Webview窗口:'+h.getURL()); }else{ console.log('应用不存在第二个首页Webview窗口'); }
9.mui 双首页secondwebview配置的使用
依照更新说明,在manifest.json文件的plus节点下,新增secondwebview节点配置。 "plus": { "secondwebview": { "launch_path": "_www/home.html", "id": "home" } } 这里同样支持secondWebview的styles等属性。 "plus": { "secondwebview": { "launch_path": "_www/home.html", "id": "home", "top": "50px", "bottom": "0px" } } 然后,在launchWebview中建立父子关系即可。当然,如果非必要情况下,是不用建立父子关系的。 var _self = plus.webview.getLaunchWebview(); var _second = plus.webview.getSecondWebview(); _self.append(_second); 在双首页模式下,父页面和子页面的内容是同时显示的,不会给用户造成加载延迟的感觉,大大增强了流应用及5+App的体验。
10.获取应用显示栈顶的WebviewObject窗口对象
//WebviewObject plus.webview.getTopWebview(); // 获取应用首页窗口对象 var h=plus.webview.getTopWebview(); console.log('应用显示栈顶的Webview窗口:'+h.getURL());
11.隐藏Webview窗口
//void plus.webview.hide( id_wvobj, aniHide, duration, extras ); plus.webview.hide(plus.webview.currentWebview());
12.创建并打开Webview窗口
//WebviewObject plus.webview.open( url, id, styles, aniShow, duration, showedCB ); var w = plus.webview.open('http://m.weibo.cn/u/3196963860');
13.显示Webview窗口
//void plus.webview.show( id_wvobj, aniShow, duration, showedCB, extras ); var w = plus.webview.create('http://m.weibo.cn/u/3196963860'); plus.webview.show(w); // 显示窗口
14.create页面,显示不存在父子窗口 ,父子窗口append
Webview窗口作为子窗口添加(Webview.append)到其它Webview窗口中时有效,这时其它Webview窗口为父窗口。
将另一个Webview窗口作为子窗口添加到当前Webview窗口中,添加后其所有权归父Webview窗口,父窗口显示时子窗口会自动显示,父窗口隐藏时子窗口自动隐藏,当父窗口关闭时子窗口也自动关闭。
我们不妨在子webview关闭父webview试试,结果发现子webview也被关闭了,如果不对子webview进行close()方法操作,可知子webview的生命周期是由父webview决定的。
我们可以通过对子webview进行show()、hide()操作,甚至可以使用remove移除子Webview窗口,从而实现动态子webview。这种场景最常用的是webview选项卡。
15.mui.fire()触发自定义事件
mui.fire( target , event , data )
16. 界面重新加载
location.reload();
17.窗口层级关系
append 父子关系
subpages 父子关系
openwindow 平行关系
preloadpages 平行关系
create 平行关系