,
controller: WebController
} | - | 注入JavaScript对象到window对象中,并在window对象中调用该对象及其方法。所有参数不支持更新。
object: 参与注册的对象。只能声明方法,不能声明属性
name: 参与注册对象的名称,与JS中调用的对象名一致。
methodList: 参与注册的对象中的方法列表。
controller: 控制器。 |
+| javaScriptAccess | boolean | true | 设置是否允许执行JavaScript脚本,默认允许执行。 |
+| mixedMode | [MixedMode](#MixedMode) | MixedMode.None | 设置是否允许加载超文本传输协议(HTTP)和超文本传输安全协议(HTTPS)混合内容,默认不允许加载HTTP和HTTPS混合内容。 |
+| onlineImageAccess | boolean | true | 设置是否允许从网络加载图片资源(通过HTTP和HTTPS访问的资源),默认允许访问。 |
+| zoomAccess | boolean | true | 设置是否支持手势进行缩放,默认允许执行缩放。 |
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
>
> 通用属性仅支持[width](ts-universal-attributes-size.md#属性)、[height](ts-universal-attributes-size.md#属性)、[padding](ts-universal-attributes-size.md#属性)、[margin](ts-universal-attributes-size.md#属性)、[border](ts-universal-attributes-border.md#属性)。
-- MixedMode枚举说明
+- MixedMode枚举说明
- | 名称 | 描述 |
- | ---------- | ---------------------------------------- |
- | All | 允许加载HTTP和HTTPS混合内容。 |
+ | 名称 | 描述 |
+ | ---------- | ------------------------------------------------------------ |
+ | All | 允许加载HTTP和HTTPS混合内容。 |
| Compatible | 混合内容兼容性模式,一些不安全的内容可能被安全来源加载,其他类型的内容将被阻止。 |
- | None | 不允许加载HTTP和HTTPS混合内容。 |
+ | None | HTTP和HTTPS混合内容,不加载HTTP的资源。 |
## 事件
通用事件仅支持[onFocus](ts-universal-focus-event.md#事件)。
-| 名称 | 功能描述 |
-| ---------------------------------------- | ---------------------------------------- |
-| onAlert(callback: (event?: { url: string; message: string; result: JsResult }) => boolean) | 网页触发alert()告警弹窗时触发。
url:Web组件返回的下载URL。
message:Web组件返回的信息。
JsResult:Web组件返回的弹窗确认或弹窗取消功能对象。
|
+| 名称 | 功能描述 |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| onAlert(callback: (event?: { url: string; message: string; result: JsResult }) => boolean) | 网页触发alert()告警弹窗时触发。
url:当前显示的对话框所在的网页。
message:对话框中显示的信息。
JsResult:根据用户的操作确认或取消对话框。
|
| onBeforeUnload(callback: (event?: { url: string; message: string; result: JsResult }) => boolean) | 即将离开当前页面(刷新或关闭)时触发。
url:Web组件返回的下载URL。
message:Web组件返回的信息。
JsResult:Web组件返回的弹窗确认或弹窗取消功能对象。
|
| onConfirm(callback: (event?: { url: string; message: string; result: JsResult }) => boolean) | 网页触发confirm()确认弹窗时触发。
url:Web组件返回的下载URL。
message:Web组件返回的信息。
JsResult:Web组件返回的弹窗确认或弹窗取消功能对象。
|
| onConsole(callback: (event?: { message: ConsoleMessage }) => boolean) | 向主应用报告JavaScript控制台消息时触发该回调。
message:触发的控制台信息。
|
| onDownloadStart(callback: (event?: { url: string, userAgent: string, contentDisposition: string, mimetype: string, contentLength: number }) => void) | 下载开始时触发该回调。
url:Web组件返回的下载URL。
userAgent:Web组件返回的用户代理名称。
contentDisposition:Web组件返回的响应头。
mimetype:Web组件返回的媒体类型(MIME)信息。
contentLength:Web组件返回的内容长度。
|
| onErrorReceive(callback: (event?: { request: WebResourceRequest, error: WebResourceError }) => void) | 网页加载错误时触发该回调。
request:网页的请求信息。
error:网页的错误信息 。
|
-| onGeolocationHide(callback: () => void) | 调用onGeolocationShow时发出的地理位置权限请求被取消后触发该回调。
|
-| onGeolocationShow(callback: (event?: { origin: string, geolocation: JsGeolocation }) => void) | 应用尝试使用地理位置时触发该回调,并向用户请求权限。
origin:尝试获取地理位置的Web内容的来源。
geolocation:用于请求地理位置权限。
|
| onHttpErrorReceive(callback: (event?: { request: WebResourceRequest, response: WebResourceResponse }) => void) | 网页加载出现网络错误时触发该回调。
request:网页的请求信息。
response:网页的响应信息
|
-| onPageBegin(callback: (event?: { url: string }) => void) | 网页加载时触发该回调。
url:Web组件返回的URL。
|
-| onPageEnd(callback: (event?: { url: string }) => void) | 网页加载结束时触发该回调。
url:Web组件返回的URL。
|
+| onPageBegin(callback: (event?: { url: string }) => void) | 网页加载时触发该回调。
url:Web组件返回的URL。
|
+| onPageEnd(callback: (event?: { url: string }) => void) | 网页加载结束时触发该回调。
url:Web组件返回的URL。
|
| onProgressChange(callback: (event?: { newProgress: number }) => void) | 网页加载进度变化时触发该回调。
newProgress:加载进度,取值范围为0到100的整数。
|
-| onTitleReceive(callback: (event?: { title: string }) => void) | 网页主页面标题更改时触发该回调。
title:标题内容。
|
+| onTitleReceive(callback: (event?: { title: string }) => void) | 网页主页面标题更改时触发该回调。
title:标题内容。
|
### ConsoleMessage对象说明
@@ -99,16 +95,6 @@ ohos.permission.READ_USER_STORAGE
| Log | 日志级别。 |
| Warn | 警告级别。 |
-### JsGeolocation 对象说明
-
-用于请求地理位置权限。
-
-- 接口
-
- | 接口名称 | 功能描述 |
- | ---------------------------------------- | ---------------------------------------- |
- | invoke(origin: string, allow: boolean, retain: boolean): void | 通知系统用户是否批准该应用使用地理位置权限。
origin:尝试获取地理位置的Web内容的来源。
allow:用户是否批准该应用使用地理位置权限。true: 允许访问,false: 不允许访问。
retain:是否允许将地理位置权限状态保存到系统中。true: 允许,false: 不允许。
|
-
### JsResult 对象说明
Web组件返回的弹窗确认或弹窗取消功能对象。