h5plus 当前webview_HTML5+规范：Webview的使用详解

一、知识点

Webview模块管理应用窗口界面，实现多窗口的逻辑控制管理操作。通过plus.webview可获取应用界面管理对象。

1、方法

1.1、all: 获取所有Webview窗口

Array[WebviewObject] plus.webview.all();

说明：获取应用中已创建的所有Webview窗口，包括所有未显示的Webview窗口。 返回WebviewObject对象在数组中按创建的先后顺序排列，即数组中第一个WebviewObject对象用是加载应用的入口页面。

返回值：Array[ WebviewObject] : 应用中创建的所有Webview窗口对象数组。

示例：

html>

Webview Example

// H5 plus事件处理

function plusReady(){

// 获取所有Webview窗口

var wvs=plus.webview.all();

for(var i=0;i

console.log("webview"+i+": "+wvs[i].getURL());

}

}

if(window.plus){

plusReady();

}else{

document.addEventListener("plusready",plusReady,false);

}

获取所有Webview窗口

1.2、close: 关闭Webview窗口

void plus.webview.close( id_wvobj, aniClose, duration, extras );

说明：关闭已经打开的Webview窗口，需先获取窗口对象或窗口id，并可指定关闭窗口的动画及动画持续时间。

参数：

id_wvobj: ( String | WebviewObject ) 必选 要关闭Webview窗口id或窗口对象。若操作窗口对象已经关闭，则无任何效果。 使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先打开的窗口，若没有查找到对应id的WebviewObject对象，则无任何效果。

aniClose: ( AnimationTypeClose) 可选 关闭Webview窗口的动画效果。如果没有指定关闭窗口动画，则使用默认值“auto”，即使用显示时设置的窗口动画相对应的关闭动画。

duration: ( Number ) 可选 关闭Webview窗口动画的持续时间。单位为ms，如果没有设置则使用显示窗口动画时间。

extras: ( WebviewExtraOptions) 可选 关闭Webview窗口扩展参数。可用于指定Webview窗口动画是否使用图片加速。

返回值：void : 无

示例：

html>

Webview Example

// H5 plus事件处理

function plusReady(){

}

if(window.plus){

plusReady();

}else{

document.addEventListener("plusready",plusReady,false);

}

// 关闭自身窗口

function closeme(){

var ws=plus.webview.currentWebview();

plus.webview.close(ws);

}

关闭Webview窗口

close

1.3、create: 创建新的Webview窗口

WebviewObject plus.webview.create( url, id, styles, extras );

说明：创建Webview窗口，用于加载新的HTML页面，可通过styles设置Webview窗口的样式，创建完成后需要调用show方法才能将Webview窗口显示出来。

参数：

url: ( String ) 可选 新窗口加载的HTML页面地址。新打开Webview窗口要加载的HTML页面地址，可支持本地地址和网络地址。

id: ( String ) 可选 新窗口的标识。窗口标识可用于在其它页面中通过getWebviewById来查找指定的窗口，为了保持窗口标识的唯一性，应该避免使用相同的标识来创建多个Webview窗口。 如果传入无效的字符串则使用url参数作为WebviewObject窗口的id值。

styles: ( WebviewStyles) 可选 创建Webview窗口的样式(如窗口宽、高、位置等信息)

extras: ( JSON ) 可选 创建Webview窗口的额外扩展参数。值为JSON类型，设置扩展参数后可以直接通过Webview的点(“.”)操作符获取扩展参数属性值，如： var w=plus.webview.create('url.html','id',{},{preload:"preload webview"}); // 可直接通过以下方法获取preload值 console.log(w.preload); // 输出值为“preload webview”

返回值：WebviewObject : Webview窗口对象

示例：

html>

Webview Example

// H5 plus事件处理

function plusReady(){

}

if(window.plus){

plusReady();

}else{

document.addEventListener("plusready",plusReady,false);

}

// 创建并显示新窗口

function create(){

var w=plus.webview.create( "http://weibo.com/dhnetwork" );

w.show(); // 显示窗口

}

创建新的Webview窗口

Create

1.4、currentWebview: 获取当前窗口的WebviewObject对象

WebviewObject plus.webview.currentWebview();

说明：获取当前页面所属的Webview窗口对象。

返回值：WebviewObject : Webview窗口对象

示例：

html>

Webview Example

// H5 plus事件处理

function plusReady(){

var ws=plus.webview.currentWebview();

console.log( "当前Webview窗口："+ws.g