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

最新推荐文章于 2024-12-05 21:05:41 发布

原创最新推荐文章于 2024-12-05 21:05:41 发布 · 1.7k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#webview #javascript

编程小技能专栏收录该内容

324 篇文章

订阅专栏

本文详尽介绍了Webview窗口的创建、管理和操作方法，包括窗口的打开、关闭、隐藏与显示，以及如何设置样式、加载内容、处理事件等。深入探讨了Webview的动画、分享参数、子View控件等高级功能。

属性：

isRecovery: 当前Webview窗口是否由于内核崩溃自动恢复

方法：

all: 获取所有Webview窗口
close: 关闭Webview窗口
create: 创建新的Webview窗口
currentWebview: 获取当前窗口的WebviewObject对象
getDisplayWebview: 获取屏幕所有可视的Webview窗口
getWebviewById: 查找指定标识的WebviewObject窗口
getLaunchWebview: 获取应用首页WebviewObject窗口对象
getSecondWebview: 获取应用第二个首页WebviewObject窗口对象
getTopWebview: 获取应用显示栈顶的WebviewObject窗口对象
hide: 隐藏Webview窗口
open: 创建并打开Webview窗口
prefetchURL: 预载网络页面
prefetchURLs: 预载网络页面（多个地址）
show: 显示Webview窗口
startAnimation: Webview窗口组合动画
defaultHardwareAccelerated: 获取Webview默认是否开启硬件加速

对象：

AnimationTypeShow: 一组用于定义页面或控件显示动画效果
AnimationTypeClose: 一组用于定义页面或控件关闭的动画效果
WebviewObject: Webview窗口对象，用于操作加载HTML页面的窗口
WebviewAnimationOptions: Webview窗口动画参数
WebviewAnimationStyles: Webview窗口动画样式
WebviewBounceStyle: Webview窗口回弹样式
WebviewContentAnimationOptions: Webview窗口内容动画参数
WebviewDock: 原生控件在窗口中停靠的方式
WebviewDragEvent: Webview窗口滑动事件数据
WebviewDragOptions: 窗口手势操作参数
WebviewDragOtherViewOptions: 手势操作关联对象参数
WebviewDrawOptions: 截屏绘制操作参数
WebviewFavoriteOptions: 窗口收藏参数
WebviewLoadDataOptions: 创建加载HTML数据参数
WebviewShareOptions: 窗口的分享参数
WebviewSubNViewStyles: 窗口原生子View控件样式
WebviewTitleNViewStyles: 窗口标题栏控件样式
WebviewTitleNViewBackButtonStyles: 窗口标题栏自定义返回按钮样式
WebviewTitleNViewButtonStyles: 窗口标题栏自定义按钮样式
WebviewTitleNViewSearchInputStyles: 窗口标题栏搜索框样式
WebviewProgressStyles: 标题栏控件的进度条样式
WebviewSplitLineStyles: 窗口标题栏控件的分割线样式
WebviewEvent: Webview窗口事件
WebviewExtraOptions: JSON对象，原生窗口扩展参数
WebviewPosition: 原生控件在窗口中显示的位置
WebviewPullToRefreshStyles: Webview窗口下拉刷新样式
WebviewRenderedEventOptions: Webview窗口rendered事件参数
WebviewReplaceWebApiOptions: 替换H5标准API配置信息
WebviewStatusbarStyles: JSON对象，Webview窗口的系统状态栏区域样式
WebviewStyles: JSON对象，Webview窗口对象的样式
WebviewTransform: 一组用于定义页面或控件变形的属性
WebviewTransition: 一组用于定义页面或控件转换效果的属性
WebviewOverrideResourceOptions: 拦截Webview窗口资源请求的参数
WebviewOverrideUrlOptions: 拦截Webview窗口URL请求的属性
WebviewListenResourceOptions: 监听Webview窗口资源加载的属性

回调方法：

BounceEventCallback: Webview窗口回弹事件的回调函数
EventCallback: Webview窗口事件的回调函数
PopGestureCallback: Webview窗口侧滑事件的回调函数
HistoryQueryCallback: 历史记录查询的回调函数
ListenResourceLoadingCallback: Webview窗口加载资源事件的回调函数
OverrideUrlLoadingCallback: Webview窗口拦截URL链接跳转的回调函数
TitleUpdateCallback: Webview窗口加载页面标题更新的回调函数
WebviewAnimationCallback: Webview窗口组合动画回调函数
WebviewDragCallback: Webview窗口滑屏操作事件回调函数
WebviewCustomButtonCallback: Webview窗口标题栏上自定义按钮点击事件回调函数
SuccessCallback: Webview窗口操作成功回调函数
ErrorCallback: Webview窗口操作失败回调函数

权限：

5+功能模块（permissions）

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span>
	<span style="color:#87ceeb">// ...</span>
	<span style="color:#ffa0a0">"Webview"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span>
		<span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"窗口管理"</span>
	<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
			</code></span></span>

isRecovery

当前Webview窗口是否由于内核崩溃自动恢复

<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">webview</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isRecovery</span><span style="color:#ffffff">;</span>
				</code></span></span>

说明：

Boolean 类型只读属性

如果当前窗口是由于内核（WKWebview）崩溃恢复则返回true，否则返回false。注意：仅iOS平台使用WKWebview内核时生效。

平台支持：

Android - ALL (不支持)
iOS - 8.0+ (支持)

defaultHardwareAccelerated

获取Webview默认是否开启硬件加速

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">Boolean</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">webview</span><span style="color:#ffffff">.</span><span style="color:#ffffff">defaultHardwareAccelerated</span><span style="color:#ffffff">();</span>
				</code></span></span>

说明：

由于不同设备对硬件加速的支持情况存在差异，开启硬件加速能加速HTML页面的渲染，但也会消耗更多的系统资源，从而导致在部分设备上可能出现闪屏、发虚、分块渲染等问题，因此5+ Runtime会根据设备实际支持情况自动选择是否开启硬件加速。关闭硬件加速则可能会导致Webview页面无法支持Video标签播放视频等问题，如果在特定情况下需要调整修改默认开启硬件加速的行为，则可通过plus.webview.defaultHardwareAccelerated()方法获取当前设备默认是否开启硬件加速状态，从而决定是否需要显式开启或关闭指定Webview的硬件加速功能（通过WebviewStyles的hardwareAccelerated属性设置）。

参数：

无

返回值：

Boolean : Webview窗口默认开启硬件加速则返回true，否则返回false。

平台支持：

Android - 2.3+ (支持) :
返回当前设备默认是否开启硬件加速。
iOS - 5.1+ (不支持) :
返回固定值true。

示例：

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 创建新窗口并设置开启硬件加速</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> create</span><span style="color:#ffffff">(){</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> styles</span><span style="color:#ffffff">={};</span>
	<span style="color:#87ceeb">// 在Android5以上设备，如果默认没有开启硬件加速，则强制设置开启</span>
	<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(!</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">webview</span><span style="color:#ffffff">.</span><span style="color:#ffffff">defaultHardwareAccelerated</span><span style="color:#ffffff">()&&</span><span style="color:#ffffff">parseInt</span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">os</span><span style="color:#ffffff">.</span><span style="color:#ffffff">version</span><span style="color:#ffffff">)>=</span><span style="color:#cd5c5c">5</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
		styles</span><span style="color:#ffffff">.</span><span style="color:#ffffff">hardwareAccelerated</span><span style="color:#ffffff">=</span><span style="color:#f0e68c"><strong>true</strong></span><span style="color:#ffffff">;</span>
	<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> w </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">webview</span><span style="color:#ffffff">.</span><span style="color:#ffffff">create</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'http://m.weibo.cn/u/3196963860'</span><span style="color:#ffffff">,</span> <span style="color:#ffa0a0">'test'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> styles</span><span style="color:#ffffff">);</span><span style="color:#ffffff">
	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">webview</span><span style="color:#ffffff">.</span><span style="color:#ffffff">show</span><span style="color:#ffffff">(</span><span style="color:#ffffff">w</span><span style="color:#ffffff">);</span> <span style="color:#87ceeb">// 显示窗口</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

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

属性：

方法：

对象：

回调方法：

权限：

说明：

平台支持：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

平台支持：

示例：

常量：

平台支持

平台支持

平台支持

平台支持

平台支持

平台支持

平台支持

平台支持