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

代码效果：