html5Plus学习-Webview（1）

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');}

代码效果：