webview
Webview模块管理应用窗口界面,实现多窗口的逻辑控制管理操作
这是官方的解释
意思就是指首页运行的窗口
权限设置
"permissions":{
// ...
"Webview": {
"description": "窗口管理" }
}
create
创建Webview窗口,用于加载新的HTML页面,可通过styles设置Webview窗口的样式,创建完成后需要调用show方法才能将Webview窗口显示出来。
参数:
- Url(String) 可选 新窗口加载的html页面地址 支持本地地址 和网络地址
- id(String) 可选 新窗口标识
- styles (webviewStyles) 可选 新窗口的页面样式
- extras (JSON) 可选 创建webview窗口的额外扩展参数
方法返回值:
WebviewObject:webview窗口对象
示例:
//打开一个新窗口显示百度
function create(){ //页面标识为 webview01
var w = plus.webview.create('http://www.baidu.com','webview01',{width:'300px',height:'400px'});
w.show(); // 显示窗口
}
代码效果:
currentWebView
获取当前窗口的webviewObject对象
参数:
无
返回值:
webviewObject: webview窗口对象
示例:
function getCurrentWebView(){
// 获取当前Webview窗口对象
var ws=plus.webview.currentWebview();
console.log( "当前Webview窗口:"+ws.getURL() );
}`
代码效果:
all
这个方法不用讲也知道是获取所有窗口对象(包含未显示),并且当前显示的webview窗口处于数组第一个
参数:
无
返回值:
Array[WebviewObject]:应用中创建的所有webview窗口对象数组
示例:
function getAllWebView(){
var wvs=plus.webview.all();
console.log(wvs.length);
for(var i=0;i<wvs.length;i++){
console.log('webview'+i+': '+wvs[i].getURL());
}
}
代码效果:
close
关闭webview窗口
参数:
- id_wvobj: (String|webviewObject) 必选 要关闭的webview窗口id 或者 窗口对象
- aniClose:(AnimationTypeClose) 可选 关闭webview窗口的动画效果 默认值为auto
- duration(number) 可选 关闭webview窗口动画的持续时间 单位:ms
- extras(webviewExtraOptions) 可选 关闭webview窗口扩展参数
返回值:
无
示例:
// 关闭Webview窗口
function closeWebview(){
var ws=plus.webview.currentWebview();
plus.webview.close(ws);
}
代码效果:
getDisplaywebView
获取屏幕中所有可视的窗口
参数:
无
返回值:
Array[webviewObject]:屏幕中所有可视的webview窗口对象
function getDisplayWebview(){
// 获取所有可视的Webview窗口
var wvs=plus.webview.getDisplayWebview();
for(var i=0;i<wvs.length;i++){
console.log('Display webview '+i+': '+wvs[i].getURL());
}
}
getWebviewById
查看指定标识的webviewObject窗口
参数:
id(String) 必选 要查询的webview窗口id
返回值:
webviewObject: webviewObject窗口对象
示例:
function getWebviewById(){
// 查找应用首页窗口对象
var h=plus.webview.getWebviewById('webview01');
console.log( "应用Webview窗口:"+h.getURL() );
}
代码效果:
getLaunchWebview
获取应用首页WebviewObject窗口对象
参数:
无
返回值:
WebviewObject : WebviewObject窗口对象
示例:
function getLaunchWebview() {
// 获取应用首页窗口对象
var h=plus.webview.getLaunchWebview();
console.log('应用首页Webview窗口:'+h.getURL());
}
代码效果:
getSecondWebview
获取应用第二个首页WebviewObject窗口对象
参数:
无
返回值:
WebviewObject : WebviewObject窗口对象,在非双首页模式下则返回undefined。
示例:
// 获取应用第二个首页窗口对象
var h=plus.webview.getSecondWebview();
if(h){
console.log('应用第二个首页Webview窗口:'+h.getURL());
}else{
console.log('应用不存在第二个首页Webview窗口');
}
getTopWebview
获取应用显示栈顶的WebviewObject窗口对象
参数:
无
返回值:
WebviewObject : WebviewObject窗口对象
示例:
function getTopWebview(){
// 获取应用首页窗口对象
var h=plus.webview.getTopWebview();
console.log('应用显示栈顶的Webview窗口:'+h.getURL());
}
代码效果:
hide
根据指定的WebviewObject对象或id隐藏Webview窗口,使得窗口不可见。
参数:
id_wvobj: ( String | WebviewObject ) 必选 要隐藏的Webview窗口id或窗口对象
aniHide: ( AnimationTypeClose ) 可选 隐藏Webview窗口的动画效果
duration: ( Number ) 可选 隐藏Webview窗口动画的持续时间
extras: ( WebviewExtraOptions ) 可选 隐藏Webview窗口扩展参数
返回值:
void : 无
示例:
function hide(){
// 获取应用首页窗口对象
plus.webview.hide('webview01');
}
代码效果: