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

WebviewTransform

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

WebviewTransition

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

属性：

• property: (String 类型 )产生变换效果的属性

  默认值为"all"，暂不支持其它值。

  平台支持

  • Android - 2.2+ (支持)
  • iOS - 4.3+ (支持)
• duration: (String 类型 )变换持续的时间

  默认值为0，即无动画效果。

  平台支持

  • Android - 2.2+ (支持)
  • iOS - 4.3+ (支持)
• timingfunction: (String 类型 )窗口变换效果

  可取值： "linear"：匀速变化，匀速动画效果； "ease-in"：匀加速变化，逐渐变快的动画效果； "ease-out"：匀减速变化，逐渐变慢的动画效果； "ease-in-out"：先加速后减速变化，先变快后变慢的动画效果。 默认值为"ease-in-out"。

  平台支持

  • Android - 2.2+ (支持)
  • iOS - 4.3+ (支持)

WebviewOverrideResourceOptions

拦截Webview窗口资源请求的参数

属性：

• match: (String 类型 )区配需要拦截请求资源的URL地址

  支持正则表达式，默认值为空字符串（即不拦截）。

• redirect: (String 类型 )拦截重定向的资源地址

  仅支持本地资源地址，如"_www"、"_doc"、"_downloads"、"_documents"等开头的路径。

• mime: (String 类型 )重定向的资源数据类型

  RFC2045/RFC2046/RFC2047/RFC2048/RFC2049规范中定义的数据类型。 如普通文本（text/plain）、PNG图像(image/png)、GIF图形(image/gif)、JPEG图形(image/jpeg)。 如果未指定mime类型，则根据重定向资源路径自动区配。

• encoding: (String 类型 )重定向的资源数据编码

  如未设置，则使用默认值"UTF-8"。

• header: (JSON 类型 )设置重定向资源数据的http头数据

  可设置标注http头数据（如Content-type）,也可设置自定义数据。 通常可通过此属性来设置拦截资源的缓存策略（如Cache-control）。

WebviewOverrideUrlOptions

拦截Webview窗口URL请求的属性

属性：

• effect: (String 类型 )拦截URL请求生效时机

  可取值： "instant" - 表示立即生效，即调用overrideUrlLoading方法后立即生效； "touchstart" - 表示用户操作Webview窗口（触发touchstart事件）后生效，如果用户没有操作Webview窗口则不对URL请求操作进行拦截处理。 默认值为"instant"。

• mode: (String 类型 )拦截模式

  可取值： "allow"表示满足match属性定义的条件时不拦截url继续加载，不满足match属性定义的条件时拦截url跳转并触发callback回调； "reject"表示满足match属性定义的提交时拦截url跳转并触发callback回调，不满足match属性定义的条件时不拦截url继续加载。 默认值为"reject"。

• match: (String 类型 )区配是否需要处理的URL请求

  支持正则表达式，默认值为对所有URL地址生效（相当于正则表达式“.*”）。 如果mode值为"allow"则允许区配的URL请求跳转，mode值为"reject"则拦截区配的URL请求。

• exclude: (String 类型 )排除拦截处理请求类型

  不拦截处理指定类型的URL请求，直接使用系统默认处理逻辑。 可取值： "none"表示不排除任何URL请求（即拦截处理所有URL请求）； "redirect"表示排除拦截处理301/302跳转的请求（谨慎使用，非a标签的href触发的URL请求可能会误判断为302跳转）。 默认值为"none"。

WebviewListenResourceOptions

监听Webview窗口资源加载的属性

属性：

• match: (String 类型 )区配是否需要处理的URL资源

  支持正则表达式，默认值为对所有URL资源请求生效（相当于正则表达式“.*”）。 如果Webview加载的资源区配条件，则触发回调事件。

BounceEventCallback

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

参数：

• event: ( Event ) 必选 Webview窗口回弹事件触发时事件数据

  Event对象包含以下属性： status - 表示回弹位置状态，设置顶部下拉回弹changeoffset属性后可取值："beforeChangeOffset"表示可继续拖拽，此时松开拖拽窗口会回弹到其初始位置； "afterChangeOffset"表示回弹可停靠，此时松开拖拽窗口会回弹到停靠位置； "dragEndAfterChangeOffset"表示已进松开拖拽，并且窗口回弹到停靠位置。 设置左右侧侧滑slideoffset属性后可取值："beforeSlide"表示未侧滑状态；"afterSlide"表示已侧滑状态。 offset - 表示回弹方向，可取值："left"表示左侧滑动，"right"表示右侧滑动，"top"表示上侧下拉滑动。 target - 保存触发回弹此事件的Webview窗口对象。

返回值：

void : 无

示例：

uni-app使用plus注意事项

EventCallback

Webview窗口事件的回调函数

参数：

• event: ( Object ) 可选 Webview窗口事件触发时事件数据

  回调参数包含以下属性： target：保存触发此事件的Webview窗口对象； progress：保存窗口页面加载进度，仅"progressChanged"事件时有此属性。

返回值：

void : 无

示例：

uni-app使用plus注意事项

PopGestureCallback

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

参数：

• event: ( PopGestureEvent ) 必选 Webview窗口事件触发时事件数据

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

返回值：

void : 无

示例：

uni-app使用plus注意事项

HistoryQueryCallback

历史记录查询的回调函数

参数：

• event: ( Event ) 必选 查询Webview窗口历史记录操作事件数据

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

返回值：

void : 无

ListenResourceLoadingCallback

Webview窗口加载资源事件的回调函数

参数：

• event: ( Event ) 必选 Webview窗口加载资源事件数据

  可通过event的url属性获取要加载的资源URL地址。

返回值：

void : 无

OverrideUrlLoadingCallback

Webview窗口拦截URL链接跳转的回调函数

参数：

• event: ( Event ) 必选 Webview窗口拦截URL跳转事件数据

  可通过event的url属性获取拦截的URL地址。

返回值：

void : 无

TitleUpdateCallback

Webview窗口加载页面标题更新的回调函数

参数：

• event: ( Event ) 必选 Webview窗口加载页面标题更新事件数据

  可通过event的title属性获取Webview窗口的标题。

返回值：

void : 无

WebviewAnimationCallback

Webview窗口组合动画回调函数

参数：

• event: ( Event ) 必选 Webview窗口动画完成事件数据

  可通过event的id属性获取对应Webview窗口的标识，如果操作的窗口未设置id，则返回空字符串； 可通过event的target属性获取对应Webview窗口对象。

返回值：

void : 无

示例：

uni-app使用plus注意事项

WebviewDragCallback

Webview窗口滑屏操作事件回调函数

说明：

在窗口开始滑动、滑动过程、滑动结束时触发，其中滑动过程中会触发多次，滑动过程中触发次数由WebviewDragOptions对象的callbackStep决定。

参数：

• event: ( WebviewDragEvent ) 必选 Webview窗口滑动操作事件数据

返回值：

void : 无

示例：

uni-app使用plus注意事项

WebviewCustomButtonCallback

Webview窗口标题栏上自定义按钮点击事件回调函数

说明：

用户点击自定义按钮时触发。

参数：

• event: ( Event ) 必选 点击事件触发时的数据

  Event对象包含以下属性： target：触发此事件的WebviewBackButtonStyles对象。

返回值：

void : 无

SuccessCallback

Webview窗口操作成功回调函数

说明：

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

参数：

无

返回值：

void : 无

ErrorCallback

Webview窗口操作失败回调函数

参数：

• error: ( Exception ) 可选 Webview窗口操作错误信息

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

返回值：

void : 无