Webview

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

方法：

all获取所有Webview窗口
close关闭Webview窗口
create创建新的Webview窗口
currentWebview获取当前窗口的WebviewObject对象
getWebviewById查找指定标识的WebviewObject窗口
getLaunchWebview获取应用首页WebviewObject窗口对象
hide隐藏Webview窗口
open创建并打开Webview窗口
show显示Webview窗口

对象：

AnimationTypeShow一组用于定义页面或控件显示动画效果
AnimationTypeClose一组用于定义页面或控件关闭的动画效果
WebviewObjectWebview窗口对象，用于操作加载HTML页面的窗口
WebviewBounceStyleWebview窗口回弹样式
WebviewDock原生控件在窗口中停靠的方式
WebviewEventWebview窗口事件
WebviewRefreshStyleWebview窗口下拉刷新样式
WebviewPosition原生控件在窗口中显示的位置
WebviewStyleJSON对象，原生窗口设置参数的对象
WebviewTransform一组用于定义页面或控件变形的属性
WebviewTransition一组用于定义页面或控件转换效果的属性

回调方法：

BounceEventCallbackWebview窗口回弹事件的回调函数
EventCallbackWebview窗口事件的回调函数
PopGestureCallbackWebview窗口侧滑事件的回调函数
HistoryQueryCallback历史记录记录查询的回调函数
SuccessCallbackWebview窗口操作成功回调函数
ErrorCallbackWebview窗口操作失败回调函数

all

获取所有Webview窗口

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

说明：

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

返回值：

应用中创建的所有Webview窗口对象数组。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
	// 获取所有Webview窗口
	var wvs=plus.webview.all();
	for(var i=0;i<wvs.length;i++){
		console.log("webview"+i+": "+wvs[i].getURL());
	}
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
	获取所有Webview窗口
	</body>
</html>

close

关闭Webview窗口

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

说明：

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

参数：

id_wvobj (String) 可选 若操作窗口对象已经关闭，则无任何效果。使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先打开的窗口，若没有查找到对应id的WebviewObject对象，则无任何效果。
aniClose (AnimationTypeClose) 可选 如果没有指定关闭窗口动画，则使用默认值“auto”，即使用显示时设置的窗口动画相对应的关闭动画。
duration (Number) 可选 单位为ms，如果没有设置则使用显示窗口动画时间。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// 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);
}
	</script>
	</head>
	<body>
		关闭Webview窗口<br/>
		<button onclick="closeme()">close</button>
	</body>
</html>

create

创建新的Webview窗口

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

说明：

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

参数：

url (String) 可选 新打开Webview窗口要加载的HTML页面地址，可支持本地地址和网络地址。
id (String) 可选 窗口标识可用于在其它页面中通过getWebviewById来查找指定的窗口，为了保持窗口标识的唯一性，应该避免使用相同的标识来创建多个Webview窗口。如果传入无效的字符串则使用url参数作为WebviewObject窗口的id值。
styles (WebviewStyle) 可选 创建Webview窗口的样式（如窗口宽、高、位置等信息）
extras (JSON) 可选 值为JSON类型，设置扩展参数后可以直接通过Webview的点（“.”）操作符获取扩展参数属性值，如： var w=plus.webview.create('url.html','id',{},{preload:"preload webview"}); // 可直接通过以下方法获取preload值 console.log(w.preload); // 输出值为“preload webview”

返回值：

Webview窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// 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(); // 显示窗口
}
	</script>
	</head>
	<body>
		创建新的Webview窗口<br/>
		<button onclick="create()">Create</button>
	</body>
</html>

currentWebview

获取当前窗口的WebviewObject对象

WebviewObject plus.webview.currentWebview();

说明：

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

返回值：

Webview窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
	var ws=plus.webview.currentWebview();
	console.log( "当前Webview窗口："+ws.getURL() );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		获取自身Webview窗口
	</body>
</html>

getWebviewById

查找指定标识的WebviewObject窗口

WebviewObject plus.webview.getWebviewById( id );

说明：

在已创建的窗口列表中查找指定标识的Webview窗口并返回。若没有查找到指定标识的窗口则返回null，若存在多个相同标识的Webview窗口，则返回第一个创建的Webview窗口。如果要获取应用入口页面所属的Webview窗口，其标识为应用的%APPID%，可通过plus.runtime.appid获取。

参数：

id (String) 可选 要查找的Webview窗口标识

返回值：

WebviewObject窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
	// 查找应用首页窗口对象
	var h=plus.webview.getWebviewById( plus.runtime.appid );
	console.log( "应用首页Webview窗口："+h.getURL() );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		查找指定标识的窗口
	</body>
</html>

getLaunchWebview

获取应用首页WebviewObject窗口对象

WebviewObject plus.webview.getLaunchWebview();

说明：

获取应用首页WebviewObject窗口对象

返回值：

WebviewObject窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
	// 获取应用首页窗口对象
	var h=plus.webview.getLaunchWebview();
	console.log( "应用首页Webview窗口："+h.getURL() );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		获取应用首页WebviewObject窗口对象
	</body>
</html>

hide

隐藏Webview窗口

void plus.webview.hide( id_wvobj, aniHide, duration );

说明：

根据指定的WebviewObject对象或id隐藏Webview窗口，使得窗口不可见。

参数：

id_wvobj (String) 可选 使用窗口对象时，若窗口对象已经隐藏，则无任何效果。使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先打开的，若没有查找到对应id的WebviewObject对象，则无任何效果。
aniHide (AnimationTypeClose) 可选 如果没有指定窗口动画，则使用默认动画效果“none”。
duration (Number) 可选 单位为ms，如果没有设置则使用默认窗口动画时间。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}

// 隐藏自身窗口
function hideeme(){
	plus.webview.hide( plus.webview.currentWebview() );
}
	</script>
	</head>
	<body>
		隐藏Webview窗口<br/>
		<button onclick="hideeme()">Hide</button>
	</body>
</html>

open

创建并打开Webview窗口

WebviewObject plus.webview.open( url, id, styles, aniShow, duration, showedCB );

说明：

创建并显示Webview窗口，用于加载新的HTML页面，可通过styles设置Webview窗口的样式，创建完成后自动将Webview窗口显示出来。

参数：

url (String) 可选 新打开Webview窗口要加载的HTML页面地址，可支持本地地址和网络地址。
id (String) 可选 窗口标识可用于在其它页面中通过getWebviewById来查找指定的窗口，为了保持窗口标识的唯一性，应该避免使用相同的标识来创建多个Webview窗口。如果传入无效的字符串则使用url参数作为WebviewObject窗口的id值。
styles (WebviewStyle) 可选 创建Webview窗口的样式（如窗口宽、高、位置等信息）
aniShow (AnimationTypeShow) 可选 如果没有指定窗口动画，则使用默认无动画效果“none”。
duration (Number) 可选 单位为ms，如果没有设置则使用默认窗口动画时间600ms。
showedCB (SuccessCallback) 可选 当指定Webview窗口显示动画执行完毕时触发回调函数，窗口无动画效果（如"none"动画效果）时也会触发此回调。

返回值：

WebviewObject窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}

// 创建并显示新窗口
function openWebview(){
	var w = plus.webview.open( "http://weibo.com/dhnetwork" );
}
	</script>
	</head>
	<body>
		打开Webview窗口<br/>
		<button onclick="openWebview()">Open</button>
	</body>
</html>

show

显示Webview窗口

void plus.webview.show( id_wvobj, aniShow, duration, showedCB );

说明：

显示已创建或隐藏的Webview窗口，需先获取窗口对象或窗口id，并可指定显示窗口的动画及动画持续时间。

参数：

id_wvobj (String) 可选 若操作Webview窗口对象显示，则无任何效果。使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先创建的窗口，若没有查找到对应id的WebviewObject对象，则无任何效果。
aniShow (AnimationTypeShow) 可选 如果没有指定窗口动画类型，则使用默认值“auto”，即自动选择上一次显示窗口的动画效果，如果之前没有显示过，则使用“none”动画效果。
duration (Number) 可选 单位为ms，如果没有设置则使用默认窗口动画时间600ms。
showedCB (SuccessCallback) 可选 当指定Webview窗口显示动画执行完毕时触发回调函数，窗口无动画效果（如"none"动画效果）时也会触发此回调。

返回值：

Webview窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// 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" );
	plus.webview.show( w ); // 显示窗口
}
	</script>
	</head>
	<body>
		显示Webview窗口<br/>
		<button onclick="create()">Create</button>
	</body>
</html>

AnimationTypeShow

一组用于定义页面或控件显示动画效果

AnimationTypeClose

一组用于定义页面或控件关闭的动画效果

WebviewObject

Webview窗口对象，用于操作加载HTML页面的窗口

方法：

addEventListener添加事件监听器
append在Webview窗口中添加子窗口
appendJsFile添加Webview窗口预加载js文件
back后退到上次加载的页面
canBack查询Webview窗口是否可后退
canForward查询Webview窗口是否可前进
children获取Webview窗口的所有子Webview窗口
clear清空原生Webview窗口加载的内容
close关闭Webview窗口
evalJS在Webview窗口中执行JS脚本
forward前进到上次加载的页面
getStyle获取Webview窗口的样式
getTitle获取Webview窗口加载HTML页面的标题
getURL获取Webview窗口加载HTML页面的地址
hide隐藏Webview窗口
isVisible查询Webview窗口是否可见
loadData加载新HTML数据
loadURL加载新URL页面
nativeInstanceObject获取Webview窗口对象的原生（Native.JS）实例对象
opened获取在当前Webview窗口中创建的所有窗口
opener获取当前Webview窗口的创建者
parent获取当前Webview窗口的父窗口
reload重新加载Webview窗口显示的HTML页面
resetBounce重置Webview窗口的回弹位置
remove移除子Webview窗口
removeEventListener移除Webview窗口事件监听器
removeFromParent从父窗口中移除
setBounce设置Webview窗口的回弹效果
setBlockNetworkImage设置Webview窗口是否阻塞加载页面中使用的网络图片
setContentVisible设置HTML内容是否可见
setPullToRefresh设置Webview窗口的下拉刷新效果
setStyle设置Webview窗口的样式
setJsFile设置预加载的JS文件
show显示Webview窗口
stop停止加载HTML页面内容

事件：

oncloseWebview窗口关闭事件
onerrorWebview窗口错误事件
onloadedWebview窗口页面加载完成事件
onloadingWebview窗口页面开始加载事件

属性：

id：String，在打开或创建Webview窗口时设置，如果没有设置窗口标识，此属性值为undefined。

addEventListener

添加事件监听器

wobj.addEventListener( event, listener, capture );

说明：

向Webview窗口添加事件监听器，当指定的事件发生时，将触发listener函数的执行。可多次调用此方法向Webview添加多个监听器，当监听的事件发生时，将按照添加的先后顺序执行。

参数：

event (WebviewEvent) 可选 Webview窗口事件类型
listener (EventCallback) 可选 监听事件发生时执行的回调函数
capture (Boolean) 可选 捕获事件流顺序，暂无效果

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}

var nw=null;
// 监听Webview窗口事件
function eventTest() {
	if(nw){return;}
	var w=plus.nativeUI.showWaiting()
	// 打开新窗口
	nw=plus.webview.create( "http://weibo.com/dhnetwork" );
	nw.addEventListener( "loaded", function(){
		console.log( "New Window loaded!" );
		nw.show(); // 显示窗口
		w.close();
		w=null;
	}, false );
}
	</script>
	</head>
	<body>
		添加事件监听器<br/>
		<button onclick="eventTest()">Event Listener</button>
	</body>
</html>

append

在Webview窗口中添加子窗口

void wobj.append( webview );

说明：

将另一个Webview窗口作为子窗口添加到当前Webview窗口中，添加后其所有权归父Webview窗口，当父窗口关闭时子窗口自动关闭。

参数：

webview (WebviewObject) 可选 被添加的Webview窗口需通过plus.webview.create方法创建，并且不能调用其show方法进行显示。父窗口显示时子窗口会自动显示，父窗口隐藏时子窗口也会自动隐藏。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		在Webview窗口中添加子窗口
		<button onclick="plus.webview.currentWebview().close();">Back</button>
	</body>
</html>

appendJsFile

添加Webview窗口预加载js文件

wobj.appendJsFile( file );

说明：

对于一些网络HTML页面，在无法修改HTML页面时可通过此方法自动加载本地js文件。当Webview窗口跳转到新页面时也会自动加载指定的js执行，添加多个js文件将按照添加的先后顺序执行。

参数：

file (String) 可选 js文件路径只支持本地文件，应该使用扩展相对路径类型的文件，如"_www/preload.js"。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
	var nw=plus.webview.create("http://weibo.com/dhnetwork");
	nw.appendJsFile("_www/preload.js");
	nw.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		添加Webview窗口预加载js文件
	</body>
</html>

back

后退到上次加载的页面

void wobj.back();

说明：

Webview窗口历史记录操作，后退到窗口上次加载的HTML页面。如果窗口历史记录中没有可后退的页面则不触发任何操作。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 返回上次页面
function goBack() {
	embed.back();
}
// 前进到上次页面
function goForward() {
	embed.forward();
}
	</script>
	</head>
	<body>
		后退到上次加载的页面
		<button onclick="goBack()">Back</button>
		<button onclick="goForward()">Forward</button>
	</body>
</html>

canBack

查询Webview窗口是否可后退

void wobj.canBack( queryCallback );

说明：

Webview窗口历史记录查询操作，获取Webview是否可后退到历史加载的页面，结果通过queryCallback回调方法返回。

参数：

queryCallback (HistoryQueryCallback) 可选 查询历史记录操作回调函数

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 是否可后退
function canBack() {
	embed.canBack( function(e){
		console.log( "是否可返回："+e.canBack );
	});
}
	</script>
	</head>
	<body>
		查询Webview窗口是否可后退
		<button onclick="canBack()">canBack</button>
	</body>
</html>

canForward

查询Webview窗口是否可前进

void wobj.canForward( queryCallback );

说明：

Webview窗口历史记录查询操作，获取Webview是否可前进到历史加载的页面，结果通过queryCallback回调方法返回。

参数：

queryCallback (HistoryQueryCallback) 可选 查询历史记录操作回调函数

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 是否可前进
function canForward() {
	embed.canForward( function(e){
		console.log( "是否可前进："+e.canForward );
	});
}
	</script>
	</head>
	<body>
		查询Webview窗口是否可前进
		<button onclick="canForward()">canForward</button>
	</body>
</html>

children

获取Webview窗口的所有子Webview窗口

Array[WebviewObject] wobj.children();

说明：

获取添加到Webview窗口中的所有子Webview窗口，如果没有子Webview窗口则返回空数组。

返回值：

包含的子Webview窗口对象数组，没有则返回空数组。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 获取子Webview窗口
function listChildren() {
	var list=plus.webview.currentWebview().children();
	for(var i=0;i<list.length;i++){
		console.log( "Children["+i+"]: "+list[i].getURL() );
	}
}
	</script>
	</head>
	<body>
		获取Webview窗口的所有子Webview窗口
		<button onclick="listChildren()">Children</button>
	</body>
</html>

clear

清空原生Webview窗口加载的内容

void wobj.clear();

说明：

清除原生窗口的内容，用于重置原生窗口加载的内容，清除其加载的历史记录等内容。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 清空Webview窗口
function webviewClear() {
	embed.clear();
}
	</script>
	</head>
	<body>
		清空原生Webview窗口加载的内容
		<button onclick="webviewClear()">Clear</button>
	</body>
</html>

close

关闭Webview窗口

void wobj.close( aniClose, duration );

说明：

关闭并销毁Webview窗口，可设置关闭动画和动画持续时间。

参数：

aniClose (AnimationTypeClose) 可选 如果没有指定关闭窗口动画，则使用默认值“auto”，即使用显示时设置的窗口动画相对应的关闭动画。
duration (Number) 可选 单位为ms，默认为窗口show方法设定的动画时间。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 关闭窗口
function closeMe() {
	ws.close();
}
	</script>
	</head>
	<body>
		关闭Webview窗口
		<button onclick="closeMe()">Close</button>
	</body>
</html>

evalJS

在Webview窗口中执行JS脚本

void wobj.evalJS( js );

说明：

将JS脚本发送到Webview窗口中运行，可用于实现Webview窗口间的数据通讯。

参数：

options (String) 可选 要在窗口中运行的脚本

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 在Webview窗口中执行JS脚本
function evalJS() {
	embed.evalJS("alert('evalJS: '+location.href);");
}
	</script>
	</head>
	<body>
		在Webview窗口中执行JS脚本
		<button onclick="evalJS()">evalJS</button>
	</body>
</html>

forward

前进到上次加载的页面

void wobj.forward();

说明：

Webview窗口历史记录操作，前进到窗口上次加载的HTML页面。如果窗口历史记录中没有可前进的页面则不触发任何操作。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var embed=null;
// H5 plus事件处理
function plusReady(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	plus.webview.currentWebview().append( embed );
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 返回上次页面
function goBack() {
	embed.back();
}
// 前进到上次页面
function goForward() {
	embed.forward();
}
	</script>
	</head>
	<body>
		前进到上次加载的页面
		<button onclick="goBack()">Back</button>
		<button onclick="goForward()">Forward</button>
	</body>
</html>

getStyle

获取Webview窗口的样式

WebviewStyle wobj.getStyle();

说明：

获取Webview窗口的样式属性，如窗口位置、大小等信息。

返回值：

WebviewStyle对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 获取Webview窗口的样式
function getStyle() {
	var style=ws.getStyle();
	alert( JSON.stringify(style) );
}
	</script>
	</head>
	<body>
		获取Webview窗口的样式
		<button onclick="getStyle()">getStyle</button>
	</body>
</html>

getTitle

获取Webview窗口加载HTML页面的标题

String wobj.getTitle();

说明：

标题为HTML页面head节点下title节点中的文本内容，当窗口内容发生页面内跳转时可通过窗口触发的“loaded”事件中调用此方法来获取跳转后页面的标题。如果HTML页面没有使用title节点来设置标题，则返回空字符串。

返回值：

窗口加载页面的标题

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 获取Webview窗口的标题
function getTitle() {
	alert( "标题为："+embed.getTitle() );
}
	</script>
	</head>
	<body>
		获取Webview窗口加载HTML页面的标题
		<button onclick="getTitle()">getTitle</button>
	</body>
</html>

getURL

获取Webview窗口加载HTML页面的地址

String wobj.getURL();

说明：

当窗口内容发生页面内跳转时可通过窗口触发的“loaded”事件中调用此方法来获取跳转后页面的地址。

返回值：

窗口加载页面的URL地址

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 获取Webview窗口加载HTML页面的地址
function getURL() {
	alert( "页面地址为："+embed.getURL() );
}
	</script>
	</head>
	<body>
		获取Webview窗口加载HTML页面的地址
		<button onclick="getURL()">getURL</button>
	</body>
</html>

hide

隐藏Webview窗口

void wobj.hide( aniHide, duration );

说明：

隐藏Webview窗口可保存已加载HTML页面的上下文数据，能降低应用使用的系统资源，通过show方法可将隐藏的Webview窗口显示出来。

参数：

aniHide (AnimationTypeClose) 可选 如果没有指定隐藏窗口动画，则使用默认动画效果“none”。
duration (Number) 可选 单位为ms，默认为窗口show方法设定的动画时间。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 隐藏Webview窗口
function hideWebview() {
	embed.hide();
}
	</script>
	</head>
	<body>
		隐藏Webview窗口
		<button onclick="hideWebview()">hide</button>
	</body>
</html>

isVisible

查询Webview窗口是否可见

Boolean wobj.isVisible();

说明：

若Webview窗口已经显示则返回true，若Webview窗口被隐藏则返回false。

返回值：

Webview窗口是否可见

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 查询Webview窗口是否可见
function visibleWebview() {
	alert( "是否可见："+embed.isVisible() );
}
// 隐藏Webview窗口
function hideWebview() {
	embed.hide();
}
	</script>
	</head>
	<body>
		查询Webview窗口是否可见
		<button onclick="visibleWebview()">isVisible</button>
		<button onclick="hideWebview()">hide</button>
	</body>
</html>

loadData

加载新HTML数据

void wobj.loadData( data );

说明：

触发Webview窗口加载HTML页面数据，如果HTML数据无效将导致页面加载失败。

参数：

data (String) 可选 要加载的HTML数据

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 加载新HTML数据
function loadHtmlData() {
	embed.loadData( '<html><body>Hello! loadData!</body></html>' );
}
	</script>
	</head>
	<body>
		加载新HTML数据
		<button onclick="loadHtmlData()">loadData</button>
	</body>
</html>

loadURL

加载新URL页面

void wobj.loadURL( url );

说明：

触发Webview窗口从新的URL地址加载页面，如果url地址无效将导致页面显示失败。

参数：

url (String) 可选 要加载的页面URL地址

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 加载新URL页面
function loadHtmlUrl() {
	embed.loadURL( 'http://m.csdn.net/' );
}
	</script>
	</head>
	<body>
		加载新URL页面
		<button onclick="loadHtmlUrl()">loadURL</button>
	</body>
</html>

nativeInstanceObject

获取Webview窗口对象的原生（Native.JS）实例对象

InstanceObject wobj.nativeInstanceObject();

说明：

Android平台返回Webview窗口对象的android.webkit.Webview实例对象， iOS平台返回Webview窗口对象的UIWebview实例对象。

返回值：

Webview窗口对象的原生（Native.JS）实例对象。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var nws=null;
// H5 plus事件处理
function plusReady(){
	// 获取当前Webview实例的原生（Native.JS）实例对象
	nws=plus.webview.currentWebview().nativeInstanceObject();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		获取Webview窗口对象的原生（Native.JS）实例对象
	</body>
</html>

opened

获取在当前Webview窗口中创建的所有窗口

Array[WebviewObject] wobj.opened();

说明：

返回从当前Webview中调用plus.webview.open或plus.webview.create创建的所有Webview窗口数组。

返回值：

此窗口创建的Webview窗口对象数组，没有则返回空数组。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 获取在当前Webview窗口中创建的所有窗口
function openedWebview() {
	var list=ws.opened();
	for(var i=0;i<list.length;i++){
		alert( "opened["+i+"]: "+list[i].getURL() );
	}
}
	</script>
	</head>
	<body>
		获取在当前Webview窗口中创建的所有窗口
		<button onclick="openedWebview()">opened</button>
	</body>
</html>

opener

获取当前Webview窗口的创建者

WebviewObject wobj.opener();

说明：

创建者为调用plus.webview.open或plus.webview.create方法创建当前窗口的Webview窗口。

返回值：

创建当前窗口的Webview窗口对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 取当前Webview窗口的创建者
function openerWebview() {
	var wo=embed.opener();
	alert( "opener: "+wo.getURL() );
}
	</script>
	</head>
	<body>
		获取当前Webview窗口的创建者
		<button onclick="openerWebview()">opener</button>
	</body>
</html>

parent

获取当前Webview窗口的父窗口

WebviewObject wobj.parent();

说明：

Webview窗口作为子窗口添加（Webview.append）到其它Webview窗口中时有效，这时其它Webview窗口为父窗口。

返回值：

父Webview窗口对象，没有则返回null。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 获取当前Webview窗口的父窗口
function parentWebview() {
	var wp=embed.parent();
	alert( "parent: "+wp.getURL() );
}
	</script>
	</head>
	<body>
		获取当前Webview窗口的父窗口
		<button onclick="parentWebview()">parent</button>
	</body>
</html>

reload

重新加载Webview窗口显示的HTML页面

void wobj.reload( force );

说明：

触发Webview窗口重新加载当前显示的页面内容。如果当前HTML页面未加载完则停止并重新加载，如果当前Webview窗口没有加载任何页面则无响应。

参数：

force (Boolean) 可选 为加速HTML页面加载速度，默认在重新加载时会使用缓存，若force设置为true则不使用缓存，重新从URL地址加载所有页面内容。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 重新加载Webview窗口显示的HTML页面
function reloadWebview() {
	embed.reload(true);
}
	</script>
	</head>
	<body>
		重新加载Webview窗口显示的HTML页面
		<button onclick="reloadWebview()">reload</button>
	</body>
</html>

resetBounce

重置Webview窗口的回弹位置

void wobj.resetBounce();

说明：

开启窗口回弹效果后，当窗口中展现的内容滚动到头（顶部或底部）时，再拖拽时窗口整体内容将跟随移动，松开后自动回弹到停靠位置。这时需要调用此方法来重置窗口的回弹位置，窗口将采用动画方式回弹到其初始显示的位置。

返回值：

无

平台支持：

Android : 2.2+

iOS : 不支持

WP : 不支持

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	ws.setBounce({position:{top:"100px"},changeoffset:{top:"44px"}});
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 重置窗口回弹位置
function resetBounce(){
	ws.resetBounce();
}
	</script>
	</head>
	<body style="text-align:center;">
		<br/><br/><br/>
		设置Webview窗口的回弹效果<br/>
		回弹后显示停靠到44px的位置<br/><br/>
		<button onclick="resetBounce()">重置回弹位置</button>
		<br/><br/><br/>
		*暂仅支持顶部的回弹效果*
	</body>
</html>

remove

移除子Webview窗口

void wobj.remove( webview );

说明：

从当前Webview窗口移除指定的子Webview窗口，若指定的webview对象不是当前窗口的子窗口则无任何作用。移除后子Webview窗口不会关闭，需要调用其close方法才能真正关闭并销毁。

参数：

webview (WebviewObject) 可选 要移除的Webview窗口

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 移除子Webview窗口
function removeWebview() {
	ws.remove(embed);
	embed.close();
}
	</script>
	</head>
	<body>
		移除子Webview窗口
		<button onclick="removeWebview()">remove</button>
	</body>
</html>

removeEventListener

移除Webview窗口事件监听器

void wobj.removeEventListener( event, listener );

说明：

从Webview窗口移除通过addEventListener方法添加的事件监听器，若没有查找到对应的事件监听器，则无任何作用。

参数：

event (NWindowEvent) 可选 要移除的事件类型
listener (EventCallback) 可选 要移除监听函数对象

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.addEventListener( "loaded", embedLoaded, false );
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 页面跳转监听器
function embedLoaded(e){
	alert( "Loaded: "+embed.getURL() );
}
// 移除Webview窗口事件监听器
function removeEvent() {
	embed.removeEventListener( "loaded", embedLoaded );
}
	</script>
	</head>
	<body>
		移除Webview窗口事件监听器
		<button onclick="removeEvent()">removeEventListener</button>
	</body>
</html>

removeFromParent

从父窗口中移除

void wobj.removeFromParent();

说明：

从所属的父Webview窗口移除，如果没有父窗口，则无任何作用。从父窗口中移除后子Webview窗口不会关闭，需要调用其close方法才能真正关闭并销毁。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 从父窗口中移除
function removeFromeWebview() {
	embed.removeFromParent();
	embed.close();
}
	</script>
	</head>
	<body>
		从父窗口中移除
		<button onclick="removeFromeWebview()">removeFromParent</button>
	</body>
</html>

setBounce

设置Webview窗口的回弹效果

void wobj.setBounce( style );

说明：

开启窗口回弹效果后，当窗口中展现的内容滚动到头（顶部或底部）时，再拖拽时窗口整体内容将跟随移动，松开后自动回弹到停靠位置（可通过style设置）。拖拽窗口内容时页面显示Webview窗口的背景色，默认为透明，此时显示Webview下面的内容，利用这个特点可以实现自定下拉刷新特效。

参数：

style (WebviewBounceStyle) 可选 可设置窗口的回弹效果支持的方向，自动回弹后停靠的位置等参数。

返回值：

无

平台支持：

Android : 2.2+

iOS : 不支持

WP : 不支持

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	ws.setBounce({position:{top:"100px"},changeoffset:{top:"0px"}});
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body style="text-align:center;">
		<br/><br/><br/>
		设置Webview窗口的回弹效果<br/><br/><br/>
		*暂仅支持顶部的回弹效果*
	</body>
</html>

setBlockNetworkImage

设置Webview窗口是否阻塞加载页面中使用的网络图片

void wobj.setBlockNetworkImage( block );

说明：

设置Webview窗口是否阻塞加载页面中使用的网络图片

参数：

block (Boolean) 可选 true表示不加载页面中使用的网络图片，false表示加载也页面中使用的网络图片。

返回值：

无

平台支持：

Android : 2.2+

iOS : 不支持

WP : 不支持

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null;
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
function blockOpen(){
	// 阻塞网络图片模式打开页面
	var w=plus.webview.create("http://m.csdn.net/","csdn",{blockNetworkImage:true});
	w.addEventListener("loaded",function(){
		w.show("slide-in-right",300);
		// 加载网络图片
		w.setBlockNetworkImage(false);
	},false);
}
	</script>
	</head>
	<body>
		显示窗口后再加载网络图片<br/>
		<button onclick="blockOpen()">打开页面</button>
	</body>
</html>

setContentVisible

设置HTML内容是否可见

void wobj.setContentVisible( visible );

说明：

设置HTML内容不可见后，将显示Webview窗口的背景色。

参数：

visible (Boolean) 可选 设置页面是否可见，true表示可见，false表示不可见

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 设置HTML内容是否可见
function setContentVisible(v) {
	embed.setContentVisible(v);
}
	</script>
	</head>
	<body>
		设置HTML内容是否可见
		<button onclick="setContentVisible(true)">可见</button>
		<button onclick="setContentVisible(false)">不可见</button>
	</body>
</html>

setPullToRefresh

设置Webview窗口的下拉刷新效果

void wobj.setPullToRefresh( style, refreshCB );

说明：

开启Webview窗口的下拉刷新功能，显示窗口内置的下拉刷新控件样式。

参数：

style (WebviewRefreshStyle) 可选 可设置窗口内置的下拉刷新控件在各种状态显示的文字内容。
refreshCB (SuccessCallback) 可选 用户操作窗口的下拉刷新触发窗口刷新事件时触发。

返回值：

无

平台支持：

Android : 2.2+

iOS : ALL

WP : 不支持

示例：

<!DOCTYPE HTML>
<html>
	<head>
		<meta charset="utf-8"/>
		<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
		<meta name="HandheldFriendly" content="true"/>
		<meta name="MobileOptimized" content="320"/>
		<title>Webview Example</title>
		<script type="text/javascript" charset="utf-8">
var ws=null;
var list=null;
// 扩展API加载完毕，现在可以正常调用扩展API 
function plusReady(){
	ws=plus.webview.currentWebview();
	ws.setPullToRefresh({support:true,
		height:"50px",
		range:"200px",
		contentdown:{
			caption:"下拉可以刷新"
		},
		contentover:{
			caption:"释放立即刷新"
		},
		contentrefresh:{
			caption:"正在刷新..."
		}
	},onRefresh);
	plus.nativeUI.toast("下拉可以刷新");
}
// 判断扩展API是否准备，否则监听"plusready"事件
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// DOM构建完成获取列表元素
document.addEventListener("DOMContentLoaded",function(){
	list=document.getElementById("list");
})
// 刷新页面
function onRefresh(){
	setTimeout(function(){
		if(list){
			var item=document.createElement("li");
			item.innerHTML="<span>New Item "+(new Date())+"</span>";
			list.insertBefore(item,list.firstChild);
		}
		ws.endPullToRefresh();
	},2000);
}
		</script>
		<link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8"/>
		<style type="text/css">
li {
	padding: 1em;
	border-bottom: 1px solid #eaeaea;
}
li:active {
	background: #f4f4f4;
}
		</style>
	</head>
	<body>
		<ul id="list" style="list-style:none;margin:0;padding:0;">
			<li><span>Initializ List Item 1</span></li>
			<li><span>Initializ List Item 2</span></li>
			<li><span>Initializ List Item 3</span></li>
			<li><span>Initializ List Item 4</span></li>
			<li><span>Initializ List Item 5</span></li>
			<li><span>Initializ List Item 6</span></li>
			<li><span>Initializ List Item 7</span></li>
			<li><span>Initializ List Item 8</span></li>
			<li><span>Initializ List Item 9</span></li>
			<li><span>Initializ List Item 10</span></li>
		</ul>
	</body>
</html>

setStyle

设置Webview窗口的样式

void wobj.setStyle( styles );

说明：

更新Webview窗口的样式，如窗口位置、大小、背景色等。

参数：

styles (WebviewStyle) 可选 要设置的窗口样式

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 设置Webview窗口的样式
function updateStyle() {
	embed.setStyle( {top:"92px"} );
}
	</script>
	</head>
	<body>
		设置Webview窗口的样式
		<button onclick="updateStyle()">setStyle</button>
	</body>
</html>

setJsFile

设置预加载的JS文件

void wobj.setJsFile( path );

说明：

预加载JS文件不需要在HTML页面中显式引用，在Webview窗口加载HTML页面时自动加载，在页面跳转时也会自动加载。设置新的JS文件后将清空之前设置的值。

参数：

file (String) 可选 预载入的JS文件地址，仅支持本地文件，格式为相对路径URL（plus.io.RelativeURL），如"_www/preload.js"

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.setJsFile( "_www/js/preload.js" );
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
	</script>
	</head>
	<body>
		设置预加载的JS文件
	</body>
</html>

show

显示Webview窗口

void wobj.show( aniShow, duration, showedCB );

说明：

当调用plus.webview.create方法创建Webview窗口后，需要调用其show方法才能显示，并可设置窗口显示动画及动画时间。 Webview窗口被隐藏后也可调用此方法来重新显示。

参数：

showedCB (SuccessCallback) 可选 当指定Webview窗口显示动画执行完毕时触发回调函数，窗口无动画效果（如"none"动画效果）时也会触发此回调。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 创建并显示Webview窗口
function showWebview(){
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.show( "slide-in-right", 300 );
}
	</script>
	</head>
	<body>
		显示Webview窗口
		<button onclick="showWebview()">show</button>
	</body>
</html>

stop

停止加载HTML页面内容

void wobj.stop();

说明：

触发Webview窗口停止加载页面内容，如果已经加载部分内容则显示部分内容，如果加载完成则显示全部内容。

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 停止加载HTML页面内容
function stopWebview(){
	embed.stop();
}
	</script>
	</head>
	<body>
		停止加载HTML页面内容
		<button onclick="stopWebview()">stop</button>
	</body>
</html>

onclose

Webview窗口关闭事件

说明：

当Webview窗口关闭时触发此事件，类型为EventCallback。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.onclose=embedClose;
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 页面关闭事件回调函数
function embedClose(e){
	alert( "Closed!" );
}
	</script>
	</head>
	<body>
		Webview窗口关闭事件
		<button onclick="embed.close()">onclose</button>
	</body>
</html>

onerror

Webview窗口错误事件

说明：

当Webview窗口加载错误时触发此事件，类型为EventCallback。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.onerror=embedError;
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 页面错误事件回调函数
function embedError(e){
	alert( "Error!" );
}
	</script>
	</head>
	<body>
		Webview窗口错误事件
		<button onclick="embed.loadData('<xml>Not html</xml>')">onerror</button>
	</body>
</html>

onloaded

Webview窗口页面加载完成事件

说明：

当Webview窗口页面加载完成时触发此事件，类型为EventCallback。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.onloaded=embedLoaded;
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 页面加载完成事件回调函数
function embedLoaded(e){
	alert( "Loaded!" );
}
	</script>
	</head>
	<body>
		Webview窗口页面加载完成事件
		<button onclick="embed.loadURL('http://m.csdn.net')">onloaded</button>
	</body>
</html>

onloading

Webview窗口页面开始加载事件

说明：

当Webview窗口开始加载新页面时触发此事件，类型为EventCallback。

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Webview Example</title>
	<script type="text/javascript">
var ws=null,embed=null;
// H5 plus事件处理
function plusReady(){
	ws=plus.webview.currentWebview();
	embed=plus.webview.create("http://weibo.com/dhnetwork","",{top:"46px",bottom:"0px"});
	embed.onloading=embedLoading;
	ws.append(embed);
}
if(window.plus){
	plusReady();
}else{
	document.addEventListener("plusready",plusReady,false);
}
// 页面开始加载事件回调函数
function embedLoading(e){
	alert( "Loading!" );
}
	</script>
	</head>
	<body>
		Webview窗口页面开始加载事件
		<button onclick="embed.loadURL('http://m.csdn.net')">onloading</button>
	</body>
</html>

WebviewBounceStyle

Webview窗口回弹样式

属性：

position：JSON，可通过此参数设置开启Webview哪个方向支持回弹效果。支持以下属性： top：表示窗口顶部支持回弹效果； left：表示窗口左侧支持回弹效果； right：表示窗口右侧支持回弹效果； bottom：表示窗口底部支持回弹效果。 **目前仅支持top属性** 属性值：用于指定可拖拽的范围，可取百分比，如"10%"；像素值，如"100px"；自动计算值，如"auto"；无回弹效果值，如"none"；
changeoffset：JSON，开启窗口回弹效果后，当窗口中展现的内容滚动到头（顶部或底部）时，再拖拽时窗口整体内容将跟随移动，拖拽过程中将触发"dragBounce"事件，松开后自动回弹到停靠位置。支持以下属性： top：表示窗口顶部回弹时停靠的位置； left：表示窗口左侧回弹时停靠的位置； right：表示窗口右侧回弹时停靠的位置； bottom：表示窗口底部回弹时停靠的位置。属性值：用于指定窗口回弹的位置，可取百分比，如"5%"；像素值，如"100px"；自动计算值，如"auto"，默认为可拖拽的范围值的一半；

WebviewDock

原生控件在窗口中停靠的方式

常量：

"top"控件停靠则页面顶部

平台支持：

"bottom"控件停靠在页面底部

平台支持：

"right"控件停靠在页面右侧

平台支持：

"left"控件停靠在页面左侧

平台支持：

"top"

控件停靠则页面顶部

说明：

控件停靠则页面顶部

"bottom"

控件停靠在页面底部

说明：

控件停靠在页面底部

"right"

控件停靠在页面右侧

说明：

控件停靠在页面右侧

"left"

控件停靠在页面左侧

说明：

控件停靠在页面左侧

WebviewEvent

Webview窗口事件

常量：

"close"Webview窗口关闭事件

平台支持：

"dragBounce"Webview窗口回弹事件

平台支持：

"error"Webview窗口加载错误事件

平台支持：

"hide"Webview窗口隐藏事件

平台支持：

"loading"Webview窗口页面开始加载事件

平台支持：

"loaded"Webview窗口页面加载完成事件

平台支持：

"maskClick"Webview窗口显示遮罩层时点击事件

平台支持：

"show"Webview窗口显示事件

平台支持：

"popGesture"Webview窗口侧滑返回事件

平台支持：

"close"

Webview窗口关闭事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口关闭时触发此事件，回调函数类型为EventCallback。

"dragBounce"

Webview窗口回弹事件

说明：

通过WebviewObject对象的setBounce方法开启回弹效果后，当用户拖拽窗口时触发发此事件，回调函数类型为BounceEventCallback。

"error"

Webview窗口加载错误事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口加载错误时触发此事件，回调函数类型为EventCallback。

"hide"

Webview窗口隐藏事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口隐藏（窗口动画完成后）时触发此事件，回调函数类型为EventCallback。

"loading"

Webview窗口页面开始加载事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口开始加载新页面时触发此事件，回调函数类型为EventCallback。

"loaded"

Webview窗口页面加载完成事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口页面加载完成时触发此事件，回调函数类型为EventCallback。

"maskClick"

Webview窗口显示遮罩层时点击事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口通过mask属性设置显示遮罩层并且点击时触发此事件，回调函数类型为EventCallback。

"show"

Webview窗口显示事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口显示（窗口动画完成后）时触发此事件，回调函数类型为EventCallback。

"popGesture"

Webview窗口侧滑返回事件

说明：

通过WebviewObject对象的addEventListener方法添加事件监听函数，当Webview窗口侧滑返回时触发此事件，回调函数类型为PopGestureCallback。

平台支持：

Android : 不支持不支持侧滑返回功能，不会触发此事件。

iOS : ALL

Webview设置侧滑返回功能才能触发此事件。

WP : 不支持不支持侧滑返回功能，不会触发此事件。

WebviewRefreshStyle

Webview窗口下拉刷新样式

属性：

support：Boolean，true表示开启窗口的下拉刷新功能； false表示关闭窗口的下拉刷新功能。
height：String，支持百分比，如"10%"；像素值，如"50px"。
range：String，支持百分比，如"10%"；像素值，如"50px"。
contentdown：JSON，支持以下属性： caption：在下拉可刷新状态时下拉刷新控件上显示的标题内容。
contentover：JSON，支持以下属性： caption：在释放可刷新状态时下拉刷新控件上显示的标题内容。
contentrefresh：JSON，支持以下属性： caption：在正在刷新状态时下拉刷新控件上显示的标题内容。

WebviewPosition

原生控件在窗口中显示的位置

常量：

"static"控件在页面中正常定位，如果页面存在滚动条则随窗口内容滚动

平台支持：

"absolute"控件在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动

平台支持：

"dock"控件在页面中停靠，停靠的位置通过dock属性进行定义

平台支持：

"static"

控件在页面中正常定位，如果页面存在滚动条则随窗口内容滚动

说明：

控件在页面中正常定位，如果页面存在滚动条则随窗口内容滚动

"absolute"

控件在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动

说明：

控件在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动

"dock"

控件在页面中停靠，停靠的位置通过dock属性进行定义

说明：

控件在页面中停靠，停靠的位置通过dock属性进行定义

WebviewStyle

JSON对象，原生窗口设置参数的对象

属性：

background：String，窗口空白区域的背景模式，设置background为颜色值(参考CSS Color Names，可取值/十六进制值/rgb值/rgba值)，窗口为独占模式显示（占整个屏幕区域）；设置background为“transparent”，则表示窗口背景透明，为非独占模式。
blockNetworkImage：Boolean，布尔类型，true表示阻塞，false表示不阻塞，默认值为false。阻塞后Webview窗口将不加载页面中使用的所有网络图片，可通过Webview窗口对象的setBlockNetWorkImage()方法动态修改此状态。
bottom：String，支持百分比、像素值，当设置了top和height值时，此属性值忽略；
bounce：String，可取值：none表示没有反弹效果；vertical表示垂直方向有反弹效果；horizontal表示水平方向有反弹效果；all表示垂直和水平方向都有反弹效果。
bounceBackground：String，窗口回弹效果区域背景可支持颜色值或图片：颜色值格式为"#RRGGBB"，如"#FFFFFF"为设置白色背景；背景图为"url(%image path%)"，如"url(./icon.png)"为设置icon.png为背景图，图片采用平铺模式绘制。
dock：WebviewDock，当Webview窗口添加到另外一个窗口中时，停靠方式才会生效，采用停靠方式添加会导致原Webview窗口自动调整其大小避免其内容呗子窗口盖住。可取值："top"，控件停靠则页面顶部；"bottom"，控件停靠在页面底部；"right"，控件停靠在页面右侧；"left"，控件停靠在页面左侧。
height：String，支持百分比、像素值，默认为100%。未设置height属性值时，可同时设置top和bottom属性值改变窗口的默认高度。
left：String，支持百分比、像素值，默认值为0px。未设置left属性值时，可设置right属性值改变窗口的默认left位置。
margin：String，用于定位窗口的位置，支持auto，auto表示居中。若设置了left、right、top、bottom则对应的边距值失效。
mask：String，用于设置Webview窗口的遮罩层样式，遮罩层会覆盖Webview中所有内容，包括子webview，并且截获webview的所有触屏事件，此时Webview窗口的点击操作会触发maskClick事件。字符串类型，可取值： rgba格式字符串，定义纯色遮罩层样式，如"rgba(0,0,0,0.5)"，表示黑色半透明； "none"，表示不使用遮罩层；默认值为"none"，即无遮罩层。
opacity：Number，0为全透明，1为不透明，默认值为1，即不透明。
popGesture：String，可取值"none"：无侧滑返回功能；"close"：侧滑返回关闭Webview窗口；"hide"：侧滑返回隐藏webview窗口。仅iOS平台支持。
render：String，支持以下属性值： "onscreen" - Webview窗口在屏幕区可见时渲染，不可见时不进行渲染，此时能减少内存使用量； "always" - Webview在任何时候都渲染，在内存较大的设备上使用，被遮挡的窗口在此中模式下显示的时候会有更流畅的效果。默认值为"onscreen"。仅Android平台支持。
right：String，支持百分比、像素值，默认无值。当设置了left和width值时，此属性值忽略；
scalable：Boolean，窗口设置为可缩放（scalable:true）时，用户可通过双指操作放大或缩小页面，此时html页面可通过meta节点设置“name="viewport" content="user-scalable=no"”来限制页面不可缩放。窗口设置为不可缩放（scalable:false）时，用户不可通过双指操作放大或缩小页面，即使页面中的meta节点也无法开启可缩放功能。默认值为false，即不可缩放。
scrollIndicator：String，用于控制窗口滚动条样式，可取值： "all"：垂直和水平滚动条都显示； "vertical"：仅显示垂直滚动条； "horizontal"：仅显示水平滚动条； "none"：垂直和水平滚动条都不显示。默认值为"all"，即垂直和水平滚动条都显示。注意：显示滚动条的前提条件是窗口中的内容超过窗口显示的宽或高。
scrollsToTop：Boolean，true表示点击设备的状态栏可以滚动返回至顶部，false表示点击设备的状态栏不可以，默认值为true。此功能仅iOS平台支持，在iPhone上有且只有一个Webview窗口的scrollsToTop属性值为true时才生效，所以在显示和关闭Webview窗口时需动态更新所有Webview的scrollsToTop值，已确保此功能生效。
softinputMode：String，可选值：“adjustPan”- 弹出软键盘时Webview窗口自动上移，以保证当前输入框可见；“adjustResize”- 自动调整Webview窗口大小（屏幕区域减去软键盘区域），同时自动滚动Webview保证输入框可见。默认值为“adjustPan”。
top：String，支持百分比、像素值，默认值为0px。未设置top属性值时，可设置bottom属性值改变窗口的默认top位置。
transition：WebviewTransition，窗口定义窗口变换的动画效果
transform：WebviewTransform，窗口定义窗口变形效果
position：WebviewPosition，当Webview窗口添加到另外一个窗口中时，排版位置才会生效，排版位置决定子窗口在父窗口中的定位方式。可取值："static"，控件在页面中正常定位，如果页面存在滚动条则随窗口内容滚动；"absolute"，控件在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动；"dock"，控件在页面中停靠，停靠的位置由dock属性值决定。
width：String，支持百分比、像素值，默认为100%。未设置width属性值时，可同时设置left和right属性值改变窗口的默认宽度。
zindex：Number，拥有更高堆叠顺序的窗口总是会处于堆叠顺序较低的窗口的前面，拥有相同堆叠顺序的窗口后调用show方法则在前面。

WebviewTransform

一组用于定义页面或控件变形的属性

属性：

rotate：String，暂不支持
translate：String，暂不支持
scale：String，暂不支持
skew：String，暂不支持
matrix：String，暂不支持

WebviewTransition

一组用于定义页面或控件转换效果的属性

属性：

property：String，默认值为"all"，暂不支持其它值。
duration：String，默认值为0，即无动画效果。
timingfunction：String，可取值： "linear"：匀速变化，匀速动画效果； "ease-in"：匀加速变化，逐渐变快的动画效果； "ease-out"：匀减速变化，逐渐变慢的动画效果； "ease-in-out"：先加速后减速变化，先变快后变慢的动画效果。默认值为"ease-in-out"。

BounceEventCallback

Webview窗口回弹事件的回调函数

void onEvent( Event event ){
	// Event handled code.
}

说明：

Webview窗口回弹事件的回调函数

参数：

event (Event) 可选 Event对象包含以下属性： status - 表示回弹位置状态，取值包括："beforeChangeOffset"表示可继续拖拽，此时松开拖拽窗口会回弹到其初始位置； "afterChangeOffset"表示回弹可停靠，此时松开拖拽窗口会回弹到停靠位置； "dragEndAfterChangeOffset"表示已进松开拖拽，并且窗口回弹到停靠位置。 target - 保存触发回弹此事件的Webview窗口对象。

EventCallback

Webview窗口事件的回调函数

void onEvent( Event event ){
	// Event handled code.
}

说明：

Webview窗口事件的回调函数

参数：

event (Event) 可选 Event对象包含以下属性： target：保存触发回弹此事件的Webview窗口对象。

PopGestureCallback

Webview窗口侧滑事件的回调函数

void onEvent( PopGestureEvent event ){
	// Event handled code.
}

说明：

Webview窗口侧滑事件的回调函数

参数：

event (PopGestureEvent) 可选 PopGestureEvent对象包含以下属性： target：保存侧滑操作的Webview窗口对象。 type：保存侧滑事件类型，"start"表示开始侧滑返回，用户按下滑动时触发； “end”表示结束侧滑返回，用户松手时触发； “move"表示侧滑返回动作结束，用户移动侧滑时触发。 result：保存操作结果，仅在e.type为end时有效，boolean类型， true表示侧滑返回执行，false表示侧滑返回取消；否则为undefined。 progress：保存侧滑位置，Number类型，可带小数点，范围为0-100。

HistoryQueryCallback

历史记录记录查询的回调函数

void onQuery( Event event ) {
	// Event handled code.
}

说明：

历史记录记录查询的回调函数

参数：

event (Event) 可选 可通过event的canBack属性获取Webview窗口是否可后退，通过event的canForward属性获取Webview窗口是否可前进。

SuccessCallback

Webview窗口操作成功回调函数

void onSuccess(){
	// Success code.
}

说明：

Webview窗口业务操作成功后触发回调函数。

ErrorCallback

Webview窗口操作失败回调函数

void onError(error){
	// Handle the error
	var code = error.code; // 错误编码
	var message = error.message; // 错误描述信息
}

说明：

Webview窗口操作失败回调函数

参数：

error (Exception) 可选 可通过error.code（Number类型）获取错误编码；可通过error.message（String类型）获取错误描述信息。