宜信同城网交流论坛技术专版技术专区Webview模块管理应用窗口界面，实现多窗口的逻辑控制管理操作（上） ...属性： isRecovery: 当前Webview窗口是否由于内核崩溃自动恢复方法： all: 获取所有Webview窗口 ...

admin 发表于 2023-2-16 18:54:46

Webview模块管理应用窗口界面，实现多窗口的逻辑控制管理操作（上） ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 <h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.isRecovery">isRecovery</a>: 当前Webview窗口是否由于内核崩溃自动恢复</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.all">all</a>: 获取所有Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.close">close</a>: 关闭Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.create">create</a>: 创建新的Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.currentWebview">currentWebview</a>: 获取当前窗口的WebviewObject对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.getDisplayWebview">getDisplayWebview</a>: 获取屏幕所有可视的Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.getWebviewById">getWebviewById</a>: 查找指定标识的WebviewObject窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.getLaunchWebview">getLaunchWebview</a>: 获取应用首页WebviewObject窗口对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.getSecondWebview">getSecondWebview</a>: 获取应用第二个首页WebviewObject窗口对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.getTopWebview">getTopWebview</a>: 获取应用显示栈顶的WebviewObject窗口对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.hide">hide</a>: 隐藏Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.open">open</a>: 创建并打开Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.prefetchURL">prefetchURL</a>: 预载网络页面</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.prefetchURLs">prefetchURLs</a>: 预载网络页面（多个地址）</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.show">show</a>: 显示Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.startAnimation">startAnimation</a>: Webview窗口组合动画</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.defaultHardwareAccelerated">defaultHardwareAccelerated</a>: 获取Webview默认是否开启硬件加速</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeShow">AnimationTypeShow</a>: 一组用于定义页面或控件显示动画效果</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeClose">AnimationTypeClose</a>: 一组用于定义页面或控件关闭的动画效果</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a>: Webview窗口对象，用于操作加载HTML页面的窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewAnimationOptions">WebviewAnimationOptions</a>: Webview窗口动画参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewAnimationStyles">WebviewAnimationStyles</a>: Webview窗口动画样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewBounceStyle">WebviewBounceStyle</a>: Webview窗口回弹样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewContentAnimationOptions">WebviewContentAnimationOptions</a>: Webview窗口内容动画参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDock">WebviewDock</a>: 原生控件在窗口中停靠的方式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragEvent">WebviewDragEvent</a>: Webview窗口滑动事件数据</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragOptions">WebviewDragOptions</a>: 窗口手势操作参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragOtherViewOptions">WebviewDragOtherViewOptions</a>: 手势操作关联对象参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDrawOptions">WebviewDrawOptions</a>: 截屏绘制操作参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewFavoriteOptions">WebviewFavoriteOptions</a>: 窗口收藏参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewLoadDataOptions">WebviewLoadDataOptions</a>: 创建加载HTML数据参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewShareOptions">WebviewShareOptions</a>: 窗口的分享参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewSubNViewStyles">WebviewSubNViewStyles</a>: 窗口原生子View控件样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewTitleNViewStyles">WebviewTitleNViewStyles</a>: 窗口标题栏控件样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewTitleNViewBackButtonStyles">WebviewTitleNViewBackButtonStyles</a>: 窗口标题栏自定义返回按钮样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewTitleNViewButtonStyles">WebviewTitleNViewButtonStyles</a>: 窗口标题栏自定义按钮样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewTitleNViewSearchInputStyles">WebviewTitleNViewSearchInputStyles</a>: 窗口标题栏搜索框样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewProgressStyles">WebviewProgressStyles</a>: 标题栏控件的进度条样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewSplitLineStyles">WebviewSplitLineStyles</a>: 窗口标题栏控件的分割线样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewEvent">WebviewEvent</a>: Webview窗口事件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewExtraOptions">WebviewExtraOptions</a>: JSON对象，原生窗口扩展参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewPosition">WebviewPosition</a>: 原生控件在窗口中显示的位置</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewPullToRefreshStyles">WebviewPullToRefreshStyles</a>: Webview窗口下拉刷新样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewRenderedEventOptions">WebviewRenderedEventOptions</a>: Webview窗口rendered事件参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewReplaceWebApiOptions">WebviewReplaceWebApiOptions</a>: 替换H5标准API配置信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewStatusbarStyles">WebviewStatusbarStyles</a>: JSON对象，Webview窗口的系统状态栏区域样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewStyles">WebviewStyles</a>: JSON对象，Webview窗口对象的样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewTransform">WebviewTransform</a>: 一组用于定义页面或控件变形的属性</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewTransition">WebviewTransition</a>: 一组用于定义页面或控件转换效果的属性</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewOverrideResourceOptions">WebviewOverrideResourceOptions</a>: 拦截Webview窗口资源请求的参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewOverrideUrlOptions">WebviewOverrideUrlOptions</a>: 拦截Webview窗口URL请求的属性</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewListenResourceOptions">WebviewListenResourceOptions</a>: 监听Webview窗口资源加载的属性</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.BounceEventCallback">BounceEventCallback</a>: Webview窗口回弹事件的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.EventCallback">EventCallback</a>: Webview窗口事件的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.PopGestureCallback">PopGestureCallback</a>: Webview窗口侧滑事件的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.HistoryQueryCallback">HistoryQueryCallback</a>: 历史记录查询的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.ListenResourceLoadingCallback">ListenResourceLoadingCallback</a>: Webview窗口加载资源事件的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.OverrideUrlLoadingCallback">OverrideUrlLoadingCallback</a>: Webview窗口拦截URL链接跳转的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.TitleUpdateCallback">TitleUpdateCallback</a>: Webview窗口加载页面标题更新的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewAnimationCallback">WebviewAnimationCallback</a>: Webview窗口组合动画回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragCallback">WebviewDragCallback</a>: Webview窗口滑屏操作事件回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewCustomButtonCallback">WebviewCustomButtonCallback</a>: Webview窗口标题栏上自定义按钮点击事件回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.SuccessCallback">SuccessCallback</a>: Webview窗口操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.ErrorCallback">ErrorCallback</a>: Webview窗口操作失败回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Webview": {
"description": "窗口管理"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">isRecovery</h1>
当前Webview窗口是否由于内核崩溃自动恢复
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.webview.isRecovery;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Boolean 类型只读属性
如果当前窗口是由于内核（WKWebview）崩溃恢复则返回true，否则返回false。注意：仅iOS平台使用WKWebview内核时生效。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - ALL (不支持)</li><li>iOS - 8.0+ (支持)</li></ul>
<h1 style="margin-left:0;">all</h1>
获取所有Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Array[WebviewObject] plus.webview.all();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取应用中已创建的所有Webview窗口，包括所有未显示的Webview窗口。返回WebviewObject对象在数组中按创建的先后顺序排列，即数组中第一个WebviewObject对象用是加载应用的入口页面。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Array[<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a>] : 应用中创建的所有Webview窗口对象数组。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取所有Webview窗口
var wvs=plus.webview.all();
for(var i=0;i<wvs.length;i++){
console.log('webview'+i+': '+wvs[i].getURL());
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">close</h1>
关闭Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.webview.close( id_wvobj, aniClose, duration, extras );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭已经打开的Webview窗口，需先获取窗口对象或窗口id，并可指定关闭窗口的动画及动画持续时间。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id_wvobj: ( String | <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> ) 必选 要关闭Webview窗口id或窗口对象 若操作窗口对象已经关闭，则无任何效果。使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先打开的窗口，若没有查找到对应id的WebviewObject对象，则无任何效果。 </li><li>aniClose: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeClose">AnimationTypeClose</a> ) 可选 关闭Webview窗口的动画效果 如果没有指定关闭窗口动画，则使用默认值“auto”，即使用显示时设置的窗口动画相对应的关闭动画。 </li><li>duration: ( Number ) 可选 关闭Webview窗口动画的持续时间 单位为ms，如果没有设置则使用显示窗口动画时间。 </li><li>extras: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewExtraOptions">WebviewExtraOptions</a> ) 可选 关闭Webview窗口扩展参数 可用于指定Webview窗口动画是否使用图片加速。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 关闭Webview窗口
function closeWebview(){
var ws=plus.webview.currentWebview();
plus.webview.close(ws);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">create</h1>
创建新的Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.create( url, id, styles, extras );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建Webview窗口，用于加载新的HTML页面，可通过styles设置Webview窗口的样式，创建完成后需要调用show方法才能将Webview窗口显示出来。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>url: ( String ) 可选 新窗口加载的HTML页面地址 新打开Webview窗口要加载的HTML页面地址，可支持本地地址和网络地址。 </li><li>id: ( String ) 可选 新窗口的标识 窗口标识可用于在其它页面中通过getWebviewById来查找指定的窗口，为了保持窗口标识的唯一性，应该避免使用相同的标识来创建多个Webview窗口。如果传入无效的字符串则使用url参数作为WebviewObject窗口的id值。 </li><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewStyles">WebviewStyles</a> ) 可选 创建Webview窗口的样式（如窗口宽、高、位置等信息） </li><li>extras: ( Object ) 可选 创建Webview窗口的额外扩展参数 值为JSON类型，设置扩展参数后可以直接通过Webview的点（“.”）操作符获取扩展参数属性值，如： var w=plus.webview.create('url.html','id',{},{preload:'preload webview'}); // 可直接通过以下方法获取preload值 console.log(w.preload); // 输出值为“preload webview” </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : Webview窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建并显示新窗口
function create(){
var w = plus.webview.create('http://m.weibo.cn/u/3196963860');
w.show(); // 显示窗口
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">currentWebview</h1>
获取当前窗口的WebviewObject对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.currentWebview();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取当前页面所属的Webview窗口对象。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : Webview窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取当前Webview窗口对象
var ws=plus.webview.currentWebview();
console.log( "当前Webview窗口："+ws.getURL() );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getDisplayWebview</h1>
获取屏幕所有可视的Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Array[WebviewObject] plus.webview.getDisplayWebview();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
仅在屏幕区域显示的Webview窗口，如果Webview窗口显示了但被其它Webview窗口盖住则认为不可视。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Array[<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a>] : 屏幕中可视的Webview窗口对象数组。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取所有可视的Webview窗口
var wvs=plus.webview.getDisplayWebview();
for(var i=0;i<wvs.length;i++){
console.log('Display webview '+i+': '+wvs[i].getURL());
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getWebviewById</h1>
查找指定标识的WebviewObject窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.getWebviewById( id );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
在已创建的窗口列表中查找指定标识的Webview窗口并返回。若没有查找到指定标识的窗口则返回null，若存在多个相同标识的Webview窗口，则返回第一个创建的Webview窗口。如果要获取应用入口页面所属的Webview窗口，其标识为应用的%APPID%，可通过plus.runtime.appid获取。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 要查找的Webview窗口标识 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : WebviewObject窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 查找应用首页窗口对象
var h=plus.webview.getWebviewById( plus.runtime.appid );
console.log( "应用首页Webview窗口："+h.getURL() );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getLaunchWebview</h1>
获取应用首页WebviewObject窗口对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.getLaunchWebview();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : WebviewObject窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取应用首页窗口对象
var h=plus.webview.getLaunchWebview();
console.log('应用首页Webview窗口：'+h.getURL());
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getSecondWebview</h1>
获取应用第二个首页WebviewObject窗口对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.getSecondWebview();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
在双首页模式下（在manifest.json的plus->secondwebview节点下配置），应用会自动创建两个首页Webview，通过getLaunchWebview()可获取第一个首页窗口对象，通过getSecondWebview()可获取第二个首页窗口对象。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : WebviewObject窗口对象，在非双首页模式下则返回undefined。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取应用第二个首页窗口对象
var h=plus.webview.getSecondWebview();
if(h){
console.log('应用第二个首页Webview窗口：'+h.getURL());
}else{
console.log('应用不存在第二个首页Webview窗口');
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getTopWebview</h1>
获取应用显示栈顶的WebviewObject窗口对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.getTopWebview();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : WebviewObject窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取应用首页窗口对象
var h=plus.webview.getTopWebview();
console.log('应用显示栈顶的Webview窗口：'+h.getURL());
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">hide</h1>
隐藏Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.webview.hide( id_wvobj, aniHide, duration, extras );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
根据指定的WebviewObject对象或id隐藏Webview窗口，使得窗口不可见。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id_wvobj: ( String | <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> ) 必选 要隐藏的Webview窗口id或窗口对象 使用窗口对象时，若窗口对象已经隐藏，则无任何效果。使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先打开的，若没有查找到对应id的WebviewObject对象，则无任何效果。 </li><li>aniHide: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.AnimationTypeClose">AnimationTypeClose</a> ) 可选 隐藏Webview窗口的动画效果 如果没有指定窗口动画，则使用默认动画效果“none”。 </li><li>duration: ( Number ) 可选 隐藏Webview窗口动画的持续时间 单位为ms，如果没有设置则使用默认窗口动画时间。 </li><li>extras: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewExtraOptions">WebviewExtraOptions</a> ) 可选 隐藏Webview窗口扩展参数 可用于指定Webview窗口动画是否使用图片加速。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 隐藏当前Webview窗口
function hideWebview(){
plus.webview.hide(plus.webview.currentWebview());
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">open</h1>
创建并打开Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewObject plus.webview.open( url, id, styles, aniShow, duration, showedCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建并显示Webview窗口，用于加载新的HTML页面，可通过styles设置Webview窗口的样式，创建完成后自动将Webview窗口显示出来。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>url: ( String ) 可选 打开窗口加载的HTML页面地址 新打开Webview窗口要加载的HTML页面地址，可支持本地地址和网络地址。 </li><li>id: ( String ) 可选 打开窗口的标识 窗口标识可用于在其它页面中通过getWebviewById来查找指定的窗口，为了保持窗口标识的唯一性，应该避免使用相同的标识来创建多个Webview窗口。如果传入无效的字符串则使用url参数作为WebviewObject窗口的id值。 </li><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewStyles">WebviewStyles</a> ) 可选 创建Webview窗口的样式（如窗口宽、高、位置等信息） </li><li>aniShow: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeShow">AnimationTypeShow</a> ) 可选 显示Webview窗口的动画效果 如果没有指定窗口动画，则使用默认无动画效果“none”。 </li><li>duration: ( Number ) 可选 显示Webview窗口动画的持续时间 单位为ms，默认值为200ms（毫秒）。 </li><li>showedCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.SuccessCallback">SuccessCallback</a> ) 可选 Webview窗口显示完成的回调函数 当指定Webview窗口显示动画执行完毕时触发回调函数，窗口无动画效果（如"none"动画效果）时也会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> : WebviewObject窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建并显示新窗口
function openWebview(){
var w = plus.webview.open('http://m.weibo.cn/u/3196963860');
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">prefetchURL</h1>
预载网络页面
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.webview.prefetchURL(url);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
预载网络页面会向服务器发起http/https请求获取html页面内容， 待Webview窗口加载此url页面时会则根据缓存机制优先使用预载的页面内容(加快页面显示速度)。注意：预载网络页面仅在运行期生效，为了节省内存仅保留最后5个预载页面数据。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>url: ( String ) 必选 需要预载的页面地址 必须是网络地址（http/https）,本地页面地址无需预载。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var url = 'http://m.weibo.cn/u/3196963860';

// 预载网络页面
function prefetchWebview(){
plus.webview.prefetchURL(url);
}

// 显示预载页面
function showWebview(){
// 预创建新窗口（显示在可视区域外）
wn=plus.webview.create(url, 'test',{render:'always'});
wn.show('none');
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">prefetchURLs</h1>
预载网络页面（多个地址）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.webview.prefetchURLs(urls);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
预载网络页面会向服务器发起http/https请求获取html页面内容， 待Webview窗口加载此url页面时会则根据缓存机制优先使用预载的页面内容(加快页面显示速度)。注意：预载网络页面仅在运行期生效，为了节省内存仅保留最后5个预载页面数据。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>urls: ( Array ) 必选 需要预载的页面地址数组 数组项必须是网络地址（http/https）,本地页面地址无需预载。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var urls = ['http://m.weibo.cn/u/3196963860',
'http://m3w.cn/'];

// 预载网络页面
function prefetchWebview(){
plus.webview.prefetchURLs(urls);
}

// 显示预载页面
function showWebview(){
// 创建并显示新窗口
wn=plus.webview.create(urls[0], 'test', {render:'always'});
wn.show('none');
}
function showWebview1(){
// 创建并显示新窗口
wn=plus.webview.create(urls[1], 'test1', {render:'always'});
wn.show('none');
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">show</h1>
显示Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.webview.show( id_wvobj, aniShow, duration, showedCB, extras );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
显示已创建或隐藏的Webview窗口，需先获取窗口对象或窗口id，并可指定显示窗口的动画及动画持续时间。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id_wvobj: ( String | <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> ) 必选 要显示Webview窗口id或窗口对象 若操作Webview窗口对象显示，则无任何效果。使用窗口id时，则查找对应id的窗口，如果有多个相同id的窗口则操作最先创建的窗口，若没有查找到对应id的WebviewObject对象，则无任何效果。 </li><li>aniShow: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.AnimationTypeShow">AnimationTypeShow</a> ) 可选 显示Webview窗口的动画效果 如果没有指定窗口动画类型，则使用默认值“auto”，即自动选择上一次显示窗口的动画效果，如果之前没有显示过，则使用“none”动画效果。 </li><li>duration: ( Number ) 可选 显示Webview窗口动画的持续时间 单位为ms，如果没有设置则使用默认窗口动画时间600ms。 </li><li>showedCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.SuccessCallback">SuccessCallback</a> ) 可选 Webview窗口显示完成的回调函数 当指定Webview窗口显示动画执行完毕时触发回调函数，窗口无动画效果（如"none"动画效果）时也会触发此回调。 </li><li>extras: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewExtraOptions">WebviewExtraOptions</a> ) 可选 显示Webview窗口扩展参数 可用于指定Webview窗口动画是否使用图片加速。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject">WebviewObject</a> : Webview窗口对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建并显示新窗口
function create(){
var w = plus.webview.create('http://m.weibo.cn/u/3196963860');
plus.webview.show(w); // 显示窗口
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">startAnimation</h1>
Webview窗口组合动画
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.webview.startAnimation(options, otherOptions, callback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
同步组合两个Webview窗口动画，动画完成后窗口的位置会发生变化，一次需要在动画属性参数中设置动画起始位置、结束位置等。注意：此动画操作会改变窗口位置（如left值等），再次调用show方法时需要确保其位置是否在可视区域，如果不在可视区域则需要调用窗口的setStyle方法设置其位置到可视区域内，如setStyle({left:'0px'});。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewAnimationOptions">WebviewAnimationOptions</a> ) 必选 主窗口动画属性 设置动画的主窗口及其起始位置，结束位置等信息。 </li><li>otherOptions: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewAnimationOptions">WebviewAnimationOptions</a> ) 可选 关联窗口动画属性 设置关联的窗口及其起始位置，结束位置等信息。 </li><li>callback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewAnimationCallback">WebviewAnimationCallback</a> ) 可选 Webview窗口组合动画完成回调 每个窗口动画完成时触发一次回调，可通过回调参数的id属性获取窗口的标识。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 预创建新窗口
function createWebview(){
ws=plus.webview.currentWebview();
// 创建新窗口（显示在可视区域外）
wn=plus.webview.create('http://m.weibo.cn/u/3196963860', 'newdrag',{left:'100%',render:'always'});
wn.show('none');
// 右滑隐藏新窗口
wn.drag({direction:'right',moveMode:'followFinger'}, {view:ws,moveMode:'follow'}, function(e){
console.log('Right drag event: '+JSON.stringify(e));
});
}

// 窗口组合动画
function webviewAnimation(){
plus.webview.startAnimation({view:ws,styles:{fromLeft:'0%',toLeft:'-100%'},action:'none'},
{view:wn,styles:{fromLeft:'100%',toLeft:'0%'},action:'none'},
function(e){
console.log('Animation finished: '+JSON.stringify(e));
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">defaultHardwareAccelerated</h1>
获取Webview默认是否开启硬件加速
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Boolean plus.webview.defaultHardwareAccelerated();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
由于不同设备对硬件加速的支持情况存在差异，开启硬件加速能加速HTML页面的渲染，但也会消耗更多的系统资源，从而导致在部分设备上可能出现闪屏、发虚、分块渲染等问题， 因此5+ Runtime会根据设备实际支持情况自动选择是否开启硬件加速。关闭硬件加速则可能会导致Webview页面无法支持Video标签播放视频等问题，如果在特定情况下需要调整修改默认开启硬件加速的行为，则可通过plus.webview.defaultHardwareAccelerated()方法获取当前设备默认是否开启硬件加速状态，从而决定是否需要显式开启或关闭指定Webview的硬件加速功能（通过WebviewStyles的hardwareAccelerated属性设置）。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Boolean : Webview窗口默认开启硬件加速则返回true，否则返回false。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.3+ (支持) : 返回当前设备默认是否开启硬件加速。 </li><li>iOS - 5.1+ (不支持) : 返回固定值true。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建新窗口并设置开启硬件加速
function create(){
var styles={};
// 在Android5以上设备，如果默认没有开启硬件加速，则强制设置开启
if(!plus.webview.defaultHardwareAccelerated()&&parseInt(plus.os.version)>=5){
styles.hardwareAccelerated=true;
}
var w = plus.webview.create('http://m.weibo.cn/u/3196963860', 'test', styles);
plus.webview.show(w); // 显示窗口
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AnimationTypeShow</h1>
一组用于定义页面或控件显示动画效果
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>"auto": (String 类型 )自动选择动画效果 自动选择动画效果，使用上次显示窗口设置的动画效果，如果是第一次显示则默认动画效果“none”。 </li><li>"none": (String 类型 )无动画效果 立即显示页面，无任何动画效果，页面显示默认的动画效果。此效果忽略动画时间参数，立即显示。对应关闭动画"none"。 </li><li>"slide-in-right": (String 类型 )从右侧横向滑动效果 页面从屏幕右侧外向内横向滑动显示。对应关闭动画"slide-out-right"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"slide-in-left": (String 类型 )从左侧横向滑动效果 页面从屏幕左侧向右横向滑动显示。对应关闭动画"slide-out-left"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"slide-in-top": (String 类型 )从上侧竖向滑动效果 页面从屏幕上侧向下竖向滑动显示。对应关闭动画"slide-out-top"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"slide-in-bottom": (String 类型 )从下侧竖向滑动效果 页面从屏幕下侧向上竖向滑动显示。对应关闭动画"slide-out-bottom"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"fade-in": (String 类型 )从透明到不透明逐渐显示效果 页面从完全透明到不透明逐渐显示。对应关闭动画"fade-out"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"zoom-out": (String 类型 )从小到大逐渐放大显示效果 页面在屏幕中间从小到大逐渐放大显示。对应关闭动画"zoom-in"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为100ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为100ms。 </li></ul></li><li>"zoom-fade-out": (String 类型 )从小到大逐渐放大并且从透明到不透明逐渐显示效果 页面在屏幕中间从小到大逐渐放大并且从透明到不透明逐渐显示。对应关闭动画"zoom-fade-in"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为100ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为100ms。 </li></ul></li><li>"pop-in": (String 类型 )从右侧平移入栈动画效果 页面从屏幕右侧滑入显示，同时上一个页面带阴影效果从屏幕左侧滑出隐藏。对应关闭动画"pop-out"。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 动画时间为300ms，不支持设置动画持续时间，Android6+系统上一个页面有半透明效果。此动画是新开窗口侧滑挤压当前屏幕窗口特效，必须是两个Webview窗口的组合动画， 如果当前屏幕已显示多个Webview窗口，则显示新窗口不支持此动画类型，自动转成“slide-in-right”。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li></ul>
<h1 style="margin-left:0;">AnimationTypeClose</h1>
一组用于定义页面或控件关闭的动画效果
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>"auto": (String 类型 )自动选择动画效果 自动选择显示窗口相对于的动画效果。 </li><li>"none": (String 类型 )无动画 立即关闭页面，无任何动画效果。此效果忽略动画时间参数，立即关闭。 </li><li>"slide-out-right": (String 类型 )横向向右侧滑出屏幕动画 页面从屏幕中横向向右侧滑动到屏幕外关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"slide-out-left": (String 类型 )横向向左侧滑出屏幕动画 页面从屏幕中横向向左侧滑动到屏幕外关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"slide-out-top": (String 类型 )竖向向上侧滑出屏幕动画 页面从屏幕中竖向向上侧滑动到屏幕外关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"slide-out-bottom": (String 类型 )竖向向下侧滑出屏幕动画 页面从屏幕中竖向向下侧滑动到屏幕外关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"fade-out": (String 类型 )从不透明到透明逐渐隐藏动画 页面从不透明到透明逐渐隐藏关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为200ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li><li>"zoom-in": (String 类型 )从大逐渐缩小关闭动画 页面逐渐向页面中心缩小关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为100ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为100ms。 </li></ul></li><li>"zoom-fade-in": (String 类型 )从大逐渐缩小并且从不透明到透明逐渐隐藏关闭动画 页面逐渐向页面中心缩小并且从不透明到透明逐渐隐藏关闭。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 默认动画时间为100ms。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为100ms。 </li></ul></li><li>"pop-out": (String 类型 )从右侧平移出栈动画效果 页面从屏幕右侧滑出消失，同时上一个页面带阴影效果从屏幕左侧滑入显示。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持) : 动画时间为300ms，不支持设置动画持续时间，Android6+系统上一个页面有半透明效果。 </li><li>iOS - 5.1.1+ (支持) : 默认动画时间为300ms。 </li></ul></li></ul>
<h1 style="margin-left:0;">WebviewObject</h1>
Webview窗口对象，用于操作加载HTML页面的窗口
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.id">id</a>: Webview窗口的标识</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.addEventListener">addEventListener</a>: 添加事件监听器</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.append">append</a>: 在Webview窗口中添加子窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.appendJsFile">appendJsFile</a>: 添加Webview窗口预加载js文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.animate">animate</a>: Webview窗口内容动画</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.back">back</a>: 后退到上次加载的页面</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.beginPullToRefresh">beginPullToRefresh</a>: 开始Webview窗口的下拉刷新</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.canBack">canBack</a>: 查询Webview窗口是否可后退</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.canForward">canForward</a>: 查询Webview窗口是否可前进</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.checkRenderedContent">checkRenderedContent</a>: 检测Webview窗口是否渲染完成</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.children">children</a>: 获取Webview窗口的所有子Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.clear">clear</a>: 清空原生Webview窗口加载的内容</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.close">close</a>: 关闭Webview窗口</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.drag">drag</a>: 设置Webview窗口的滑屏操作手势</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.draw">draw</a>: 截屏绘制</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.endPullToRefresh">endPullToRefresh</a>: 结束Webview窗口的下拉刷新</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.evalJS">evalJS</a>: 在Webview窗口中执行JS脚本</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.forward">forward</a>: 前进到上次加载的页面</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.getFavoriteOptions">getFavoriteOptions</a>: 获取Webview窗口的收藏参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.getSafeAreaInsets">getSafeAreaInsets</a>: 获取页面的安全区域</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.getShareOptions">getShareOptions</a>: 获取Webview窗口的分享参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.getStyle">getStyle</a>: 获取Webview窗口的样式</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122841010#plus.webview.WebviewObject.getSubNViews">getSubNViews</a>: 获取Webview窗口的原生子View控件对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.getTitle">getTitle</a>: 获取Webview窗口加载HTML页面的标题</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.getTitleNView">getTitleNView</a>: 获取Webview窗口的标题栏控件对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.getTitleNViewSearchInputText">getTitleNViewSearchInputText</a>: 获取标题栏上输入框的内容</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.getURL">getURL</a>: 获取Webview窗口加载HTML页面的地址</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.hide">hide</a>: 隐藏Webview窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.hideTitleNViewButtonRedDot">hideTitleNViewButtonRedDot</a>: 隐藏标题栏上按钮的红点</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.interceptTouchEvent">interceptTouchEvent</a>: 是否拦截Webview窗口的触屏事件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.isHardwareAccelerated">isHardwareAccelerated</a>: 查询Webview窗口是否开启硬件加速</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.isPause">isPause</a>: 查询Webview窗口是否暂停</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.isVisible">isVisible</a>: 查询Webview窗口是否可见</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.listenResourceLoading">listenResourceLoading</a>: 监听页面开始加载资源</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.loadData">loadData</a>: 加载新HTML数据</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.loadURL">loadURL</a>: 加载新URL页面</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.nativeInstanceObject">nativeInstanceObject</a>: 获取Webview窗口对象的原生（Native.JS）实例对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.opened">opened</a>: 获取在当前Webview窗口中创建的所有窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.opener">opener</a>: 获取当前Webview窗口的创建者</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.overrideResourceRequest">overrideResourceRequest</a>: 拦截Webview窗口的资源加载</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.overrideUrlLoading">overrideUrlLoading</a>: 拦截Webview窗口的URL请求</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.parent">parent</a>: 获取当前Webview窗口的父窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.pause">pause</a>: 暂停当前Webview窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.reload">reload</a>: 重新加载Webview窗口显示的HTML页面</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.resetBounce">resetBounce</a>: 重置Webview窗口的回弹位置</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.restore">restore</a>: 恢复Webview控件显示内容</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.remove">remove</a>: 移除子Webview窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.removeEventListener">removeEventListener</a>: 移除Webview窗口事件监听器</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.removeFromParent">removeFromParent</a>: 从父窗口中移除</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.removeTitleNViewButtonBadge">removeTitleNViewButtonBadge</a>: 移除标题栏上按钮的角标</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.resume">resume</a>: 恢复当前Webview窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setBounce">setBounce</a>: 设置Webview窗口的回弹效果</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setBlockNetworkImage">setBlockNetworkImage</a>: 设置Webview窗口是否阻塞加载页面中使用的网络图片</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setContentVisible">setContentVisible</a>: 设置HTML内容是否可见</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setCssFile">setCssFile</a>: 设置预加载的CSS文件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setCssText">setCssText</a>: 设置预加载的CSS内容</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setFavoriteOptions">setFavoriteOptions</a>: 设置Webview窗口的收藏参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setFixBottom">setFixBottom</a>: 设置Webview窗口底部修复区域高度</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setJsFile">setJsFile</a>: 设置预加载的JS文件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setPullToRefresh">setPullToRefresh</a>: 设置Webview窗口的下拉刷新效果</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setRenderedEventOptions">setRenderedEventOptions</a>: 设置Webview窗口rendered事件参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setSoftinputTemporary">setSoftinputTemporary</a>: 临时设置弹出系统软键盘样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setStyle">setStyle</a>: 设置Webview窗口的样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setShareOptions">setShareOptions</a>: 设置Webview窗口的分享参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setTitleNViewButtonBadge">setTitleNViewButtonBadge</a>: 设置标题栏上按钮的角标</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setTitleNViewButtonStyle">setTitleNViewButtonStyle</a>: 设置标题栏上按钮的样式</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setTitleNViewSearchInputFocus">setTitleNViewSearchInputFocus</a>: 设置标题栏上输入框是否获取输入焦点</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setTitleNViewSearchInputText">setTitleNViewSearchInputText</a>: 设置标题栏上输入框的内容</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.setVisible">setVisible</a>: 设置Webview窗口是否可见</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.show">show</a>: 显示Webview窗口</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.showBehind">showBehind</a>: 在指定Webview窗口后显示</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.showTitleNViewButtonRedDot">showTitleNViewButtonRedDot</a>: 设置标题栏上按钮的红点</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.stop">stop</a>: 停止加载HTML页面内容</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.updateSubNViews">updateSubNViews</a>: 更新Webview窗口的原生子View控件对象</li></ul>
<h2 style="margin-left:.8em;">事件：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.onclose">onclose</a>: Webview窗口关闭事件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.onerror">onerror</a>: Webview窗口错误事件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.onloaded">onloaded</a>: Webview窗口页面加载完成事件</li><li><ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject.onloading">onloading</a>: Webview窗口页面开始加载事件</li></ul>
<h1 style="margin-left:0;">id</h1>
Webview窗口的标识
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
调用<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.create">plus.webview.create</a>或<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.open">plus.webview.open</a>新建窗口时传入的id参数值，如果没有设置id参数，此属性值为undefined。注意：窗口标识只能在创建时设置，不支持动态修改，不要对此属性进行赋值操作。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取自身webview窗口
var ws=plus.webview.currentWebview();
console.log('窗口标识: '+ws.id);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">addEventListener</h1>
添加事件监听器
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
wobj.addEventListener( event, listener, capture );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
向Webview窗口添加事件监听器，当指定的事件发生时，将触发listener函数的执行。可多次调用此方法向Webview添加多个监听器，当监听的事件发生时，将按照添加的先后顺序执行。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewEvent">WebviewEvent</a> ) 必选 Webview窗口事件类型 </li><li>listener: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.EventCallback">EventCallback</a> ) 必选 监听事件发生时执行的回调函数 </li><li>capture: ( Boolean ) 可选 捕获事件流顺序，暂无效果 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var nw=null;
// 监听Webview窗口事件
function listenWebviewEvent() {
if(nw){return;}
var w=plus.nativeUI.showWaiting()
// 打开新窗口
nw=plus.webview.create('http://m.weibo.cn/u/3196963860');
nw.addEventListener('loaded', function(){
console.log('New Window loaded!');
nw.show(); // 显示窗口
w.close();
w=null;
}, false);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">append</h1>
在Webview窗口中添加子窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.append( webview );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
将另一个Webview窗口作为子窗口添加到当前Webview窗口中，添加后其所有权归父Webview窗口，当父窗口关闭时子窗口自动关闭。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>webview: ( <ahref="https://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.View">plus.nativeObj.View</a> | <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a> ) 必选 被添加的子Webview窗口或View控件对象 被添加的Webview窗口需通过plus.webview.create方法创建，并且不能调用其show方法进行显示。父窗口显示时子窗口会自动显示，父窗口隐藏时子窗口也会自动隐藏。被添加的View控件需通过new plus.nativeObj.View()创建，添加到Webview窗口后所有权一起转移（即Webview关闭后View控件也自动关闭）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//在Webview窗口中添加子窗口
embed=plus.webview.create('http://m.weibo.cn/u/3196963860', '',{top:'46px',bottom:'0px'});
plus.webview.currentWebview().append(embed);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">appendJsFile</h1>
添加Webview窗口预加载js文件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.appendJsFile( file );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
对于一些网络HTML页面，在无法修改HTML页面时可通过此方法自动加载本地js文件。当Webview窗口跳转到新页面时也会自动加载指定的js执行，添加多个js文件将按照添加的先后顺序执行。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>file: ( String ) 必选 窗口预加载的js文件地址 js文件路径只支持本地文件，应该使用扩展相对路径类型的文件，如"_www/preload.js"。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 添加Webview窗口预加载js文件
function appendJs2Webviewe(){
var nw=plus.webview.create('http://m.weibo.cn/u/3196963860');
nw.appendJsFile('_www/preload.js');
nw.show();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">animate</h1>
Webview窗口内容动画
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.animate(options, callback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
动画后可能会导致Webview窗口显示内容改变，可通过调用restore方法恢复。当Webview窗口内容动画引起内容不可见（透明），将显示此窗口后面的内容。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewContentAnimationOptions">WebviewContentAnimationOptions</a> ) 可选 Webview窗口内容动画参数 </li><li>callback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.SuccessCallback">SuccessCallback</a> ) 可选 Webview窗口内容动画结束回调函数 Webview窗口内容动画效果结束时触发。注意：动画结束时仍然会显示Webview窗口，需要调用其hide/close方法隐藏/关闭。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Webview窗口动画 
function animateWebview(){
wv.animate({type:'shrink',frames:20,region:{top:'44px',bottom:'48px'},duration:1000},function(){
wv.restore(); // 内容动画结束后可调用此动画恢复显示内容
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">back</h1>
后退到上次加载的页面
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.back();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Webview窗口历史记录操作，后退到窗口上次加载的HTML页面。如果窗口历史记录中没有可后退的页面则不触发任何操作。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var embed=null;
// 创建子窗口
function createWebview(){
embed=plus.webview.create('http://m.weibo.cn/u/3196963860', '', {top:'46px',bottom:'0px'});
plus.webview.currentWebview().append(embed);
}

// 后退到上次加载的页面
function goForward() {
embed.forward();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">beginPullToRefresh</h1>
开始Webview窗口的下拉刷新
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.beginPullToRefresh();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
开始触发下拉刷新效果，与用户操作下拉刷新行为一致（有动画效果）。触发setPullTorefresh方法设置的下拉刷新事件回调。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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,style:'circle',offset:'45px'}, onRefresh);
// 第一次打开页面即开始刷新列表
setTimeout(function(){
console.log('Initializ refresh');
ws.beginPullToRefresh();
},200);
}
// 判断扩展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='New Item '+(new Date())+'';
list.insertBefore(item,list.firstChild);
}
ws.endPullToRefresh();
},1000);
}
</script>
<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>Initializ List Item 1</li>
<li>Initializ List Item 2</li>
<li>Initializ List Item 3</li>
<li>Initializ List Item 4</li>
<li>Initializ List Item 5</li>
<li>Initializ List Item 6</li>
<li>Initializ List Item 7</li>
<li>Initializ List Item 8</li>
<li>Initializ List Item 9</li>
<li>Initializ List Item 10</li>
</ul>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">canBack</h1>
查询Webview窗口是否可后退
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.canBack( queryCallback );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Webview窗口历史记录查询操作，获取Webview是否可后退到历史加载的页面，结果通过queryCallback回调方法返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>queryCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.HistoryQueryCallback">HistoryQueryCallback</a> ) 必选 查询历史记录操作回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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://m.weibo.cn/u/3196963860', '', {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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">canForward</h1>
查询Webview窗口是否可前进
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.canForward( queryCallback );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Webview窗口历史记录查询操作，获取Webview是否可前进到历史加载的页面，结果通过queryCallback回调方法返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>queryCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.HistoryQueryCallback">HistoryQueryCallback</a> ) 必选 查询历史记录操作回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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://m.weibo.cn/u/3196963860', '', {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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">checkRenderedContent</h1>
检测Webview窗口是否渲染完成
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.checkRenderedContent(options, successCallback, errorCallback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
检测方式为判断的Webview窗口内容是否为白屏，如果非白屏则认为渲染完成，否则认为渲染未完成。通过successCallback回调函数返回结果，如果检测过程中发生错误则触发errorCallback回调函数。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewRenderedEventOptions">WebviewRenderedEventOptions</a> ) 可选 Webview窗口rendered事件参数 </li><li>successCallback: ( Function ) 必选 检测Webview窗口渲染结果回调函数 获取渲染检测结果后触发，函数原型为void function(e){}； e.rendered：表示检测渲染完成结果，Boolean类型，true表示渲染完成，false表示渲染未完成。 </li><li>errorCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.ErrorCallback">ErrorCallback</a> ) 可选 检测Webview窗口渲染结果失败回调函数 检测Webview窗口渲染结果过程中发生错误则触发errorCallback回调函数。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - ALL (不支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Webview Example</title>
<script type="text/javascript">
var nw=null;
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}

// 创建Webview窗口
function createWebview(){
// 打开新窗口
nw=plus.webview.create('http://m.weibo.cn/u/3196963860');
nw.show();
}
function checkWebview(){
nw.checkRenderedContent({}, function(e){
console.log('checkRenderedContent success: '+JSON.stringify(e));
}, function(e){
console.log('checkRenderedContent error: '+JSON.stringify(e));
});
}
</script>
</head>
<body>
检测Webview窗口是否渲染完成 
<button onclick="createWebview()">Show</button> 
<button onclick="checkWebview()">Check</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">children</h1>
获取Webview窗口的所有子Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Array[WebviewObject] wobj.children();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取添加到Webview窗口中的所有子Webview窗口，如果没有子Webview窗口则返回空数组。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Array[<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject">WebviewObject</a>] : 包含的子Webview窗口对象数组，没有则返回空数组。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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://m.weibo.cn/u/3196963860', '', {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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">clear</h1>
清空原生Webview窗口加载的内容
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.clear();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
清除原生窗口的内容，用于重置原生窗口加载的内容，清除其加载的历史记录等内容。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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://m.weibo.cn/u/3196963860', '', {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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">close</h1>
关闭Webview窗口
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.close( aniClose, duration, extras );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭并销毁Webview窗口，可设置关闭动画和动画持续时间。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>aniClose: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeClose">AnimationTypeClose</a> ) 可选 关闭Webview窗口动画效果 如果没有指定关闭窗口动画，则使用默认值“auto”，即使用显示时设置的窗口动画相对应的关闭动画。 </li><li>duration: ( Number ) 可选 关闭Webview窗口的动画持续时间 单位为ms，默认为窗口show方法设定的动画时间。 </li><li>extras: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewExtraOptions">WebviewExtraOptions</a> ) 可选 关闭Webview窗口扩展参数 可用于指定Webview窗口动画是否使用图片加速。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">drag</h1>
设置Webview窗口的滑屏操作手势
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.drag(options, otherView, callback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
将Webview窗口的左右滑动手势关联到其它Webview窗口，可实现滑动切换显示Webview的动画效果（如Tab页面切换效果）。注意：滑屏操作会改变窗口位置（如left值等），如果不在可视区域则需要调用窗口的setStyle方法设置其位置到可视区域内，如setStyle({left:'0px'});。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragOptions">WebviewDragOptions</a> ) 必选 当前Webview窗口操作手势配置参数 </li><li>otherView: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragOtherViewOptions">WebviewDragOtherViewOptions</a> ) 可选 操作手势关联的窗口配置参数 </li><li>callback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDragCallback">WebviewDragCallback</a> ) 可选 滑屏操作回调函数 在滑屏手势操作过程中触发，一次滑屏操作至少会触发3次回调事件（开始、滑屏移动、结束）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Webview Example</title>
<script type="text/javascript">
var ws=null,wn=null;
// H5 plus事件处理
function plusReady(){
ws=plus.webview.currentWebview();
// 预创建新窗口（显示在可视区域外）
wn=plus.webview.create('http://m.weibo.cn/u/3196963860', 'newdrag',{left:'100%'});
wn.show('none');
// 左滑显示新窗口
ws.drag({direction:'left',moveMode:'followFinger'}, {view:'newdrag',moveMode:'follow'}, function(e){
console.log('Left drag event: '+JSON.stringify(e));
});
// 右滑隐藏新窗口
wn.drag({direction:'right',moveMode:'followFinger'}, {view:ws,moveMode:'follow'}, function(e){
console.log('Right drag event: '+JSON.stringify(e));
});
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
</script>
</head>
<body>
左滑可打开新页面
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">draw</h1>
截屏绘制
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.draw( bitmap, successCallback, errorCallback, options );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
将Webview窗口的可视区域截屏并绘制到Bitmap图片对象中。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>bitmap: ( <ahref="https://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.Bitmap">plus.nativeObj.Bitmap</a> ) 可选 要绘制的图片对象 如果图片中已经存在内容则覆盖，如果截屏绘制失败则保留之前的图片内容。 </li><li>successCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.SuccessCallback">SuccessCallback</a> ) 可选 截屏绘制操作成功回调 截屏绘制操作成功时调用。 </li><li>errorCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.ErrorCallback">ErrorCallback</a> ) 可选 截屏绘制操作失败回调 截屏绘制操作失败时调用，并返回失败信息。 </li><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewDrawOptions">WebviewDrawOptions</a> ) 可选 截屏绘制操作参数 设置控制截屏绘制区域、是否检测白屏等。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - ALL (支持) : 不支持截取Canvas标签中的内容，也不支持截取Barcode、Map、LivePusher、VideoPlayer等原生控件的内容。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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);
}
// 截屏绘制
var bitmap=null;
function captureWebview() {
bitmap = new plus.nativeObj.Bitmap('test');
// 将webview内容绘制到Bitmap对象中
ws.draw(bitmap,function(){
console.log('截屏绘制图片成功');
},function(e){
console.log('截屏绘制图片失败：'+JSON.stringify(e));
});
}
</script>
</head>
<body>
截屏绘制Webview窗口 
<button onclick="captureWebview()">Draw</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">endPullToRefresh</h1>
结束Webview窗口的下拉刷新
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.endPullToRefresh();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭下拉刷新效果，恢复到开始下拉刷新之前的效果。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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='New Item '+(new Date())+'';
list.insertBefore(item,list.firstChild);
}
ws.endPullToRefresh();
},2000);
}
</script>
<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>Initializ List Item 1</li>
<li>Initializ List Item 2</li>
<li>Initializ List Item 3</li>
<li>Initializ List Item 4</li>
<li>Initializ List Item 5</li>
<li>Initializ List Item 6</li>
<li>Initializ List Item 7</li>
<li>Initializ List Item 8</li>
<li>Initializ List Item 9</li>
<li>Initializ List Item 10</li>
</ul>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">evalJS</h1>
在Webview窗口中执行JS脚本
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.evalJS( js );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
将JS脚本发送到Webview窗口中运行，可用于实现Webview窗口间的数据通讯。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>js: ( String ) 必选 要在窗口中运行的脚本字符串 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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://m.weibo.cn/u/3196963860', '', {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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">forward</h1>
前进到上次加载的页面
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void wobj.forward();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Webview窗口历史记录操作，前进到窗口上次加载的HTML页面。如果窗口历史记录中没有可前进的页面则不触发任何操作。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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://m.weibo.cn/u/3196963860', '', {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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getFavoriteOptions</h1>
获取Webview窗口的收藏参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewFavoriteOptions wobj.getFavoriteOptions();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取Webview窗口的收藏参数，如收藏页面的标题、图标、地址等。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewFavoriteOptions">WebviewFavoriteOptions</a> : 获取Webview窗口的收藏参数，如果未设置则返回null。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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.setFavoriteOptions({title:'收藏页标题',href:'http://www.dcloud.io/'});
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// 获取窗口的分享参数
function getFavoriteOptions(){
var t = ws.getFavoriteOptions();
alert(t?"未设置":JSON.stringify(t));
}
</script>
</head>
<body style="text-align:center;">
获取Webview窗口的收藏参数 
<button onclick="getFavoriteOptions()">获取收藏参数</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getSafeAreaInsets</h1>
获取页面的安全区域
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
SafeAreaInsets wobj.getSafeAreaInsets();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Webview窗口内容区域的安全区域位置信息。如页面底部与底部安全区域重叠10px， 则返回的bottom值为10，否则返回0。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/navigator.html#plus.navigator.SafeAreaInsets">plus.navigator.SafeAreaInsets</a> : 页面的安全区域信息
<h1 style="margin-left:0;">getShareOptions</h1>
获取Webview窗口的分享参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewShareOptions wobj.getShareOptions();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取Webview窗口的分享参数，如分享的标题、图标、链接地址等。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewShareOptions">WebviewShareOptions</a> : 获取Webview窗口的分享参数
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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.setShareOptions({title:'分享的标题',href:'http://www.dcloud.io/'});
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
// 获取窗口的分享参数
function getShareOptions(){
var t = ws.getShareOptions();
alert(t?"未设置":JSON.stringify(t));
}
</script>
</head>
<body style="text-align:center;">
获取Webview窗口的分享参数 
<button onclick="getShareOptions()">获取分享参数</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getStyle</h1>
获取Webview窗口的样式
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
WebviewStyles wobj.getStyle();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取Webview窗口的样式属性，如窗口位置、大小等信息。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewStyles">WebviewStyles</a> : WebviewStyles对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getSubNViews</h1>
获取Webview窗口的原生子View控件对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Array<plus.nativeObj.View> wobj.getSubNViews();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建Webview窗口的所有原生子View控件。可以在创建窗口时设置其subNViews属性自动创建（应用首页可通过manfest.json中的plus->launchwebview->subNNViews节点配置创建）； 也可以通过Webview窗口的append方法将已经创建的原生View控件添加为其子。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Array[<ahref="https://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.View">plus.nativeObj.View</a>] : 原生View控件对象数组，如果没有原生子View控件则返回空数组
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"/>
<title>Webview Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
plus.key.addEventListener('backbutton', function(){
nw&&nw.isVisible()?nw.hide('pop-out'):plus.runtime.quit();
}, false);
}
if(window.plus){
plusReady();
}else{
document.addEventListener('plusready', plusReady, false);
}
var nw=null;
var subNViews=null;
// 创建带原生子View控件的Webview窗口 
function createWebview(){
nw=nw||plus.webview.create('http://m.weibo.cn/u/3196963860', 'test', {popGesture:'hide',subNViews:[{
id:'subnview1',
styles:{top:'0px',height:'100px',backgroundColor:'#FF0000'},
tags:[{tag:'font',id:'font',text:'顶部原生子View控件',textStyles:{size:'18px'}}]
},{
id:'subnview2',
styles:{bottom:'0px',height:'100px',backgroundColor:'#00FF00'},
tags:[{tag:'font',id:'font',text:'底部原生子View控件',textStyles:{size:'18px'}}]
}]});
nw.addEventListener('close', function(){
nw=null;
}, false);
subNViews = nw.getSubNViews();
nw.show('pop-in');
}
// 更新顶部View控件 
function updateTopView(){
var tv = subNViews[0];
tv.drawText('更新顶部子View控件内容',{},{},'font');
}
// 更新底部View控件 
function updateBottomView(){
var bv = subNViews[0];
bv.drawText('更新底部子View控件内容',{},{},'font');
}
</script>
</head>
<body>
Webview窗口的子View控件 
<button onclick="createWebview()">Create</button> 
<button onclick="updateTopView()">更新顶部View控件</button>
<button onclick="updateBottomView()">更新底部View控件</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

Webview模块管理应用窗口界面，实现多窗口的逻辑控制管理操作（上） ...