diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-web.md b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-web.md index cce4f89bd58a20cf034c96813ba5300fc5ded5ea..c729b54fb4eace90c68b489443cc6e7ca2ebd6da 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-web.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-web.md @@ -1,9 +1,9 @@ # Web >![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** ->该组件从 API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 +>该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 -提供具有网页显示能力的 Web 组件。 +提供具有网页显示能力的Web组件。 ## 权限列表 @@ -17,57 +17,58 @@ ohos.permission.READ_USER_STORAGE ## 接口 -- Web\(options: {src: string, controller?: WebController}\) +- Web\(options: { src: string, controller?: WebController }\) - 表1 options 参数说明 + 表1 options参数说明 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | ---------- | ------------------------------- | ---- | ------ | -------------- | - | src | string | 是 | - | 网页资源地址。 | - | controller | [WebController](#WebController) | 否 | - | 控制器。 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ---------- | ------------------------------- | ---- | ---- | ------- | + | src | string | 是 | - | 网页资源地址。 | + | controller | [WebController](#WebController) | 否 | - | 控制器。 | > ![icon-note.gif](public_sys-resources/icon-note.gif)**说明:** > -> - 一个页面只支持一个 Web 组件,全屏显示,页面中的其他组件会被 Web 组件遮挡; > - 不支持转场动画; -> - 只支持加载 rawfile 目录下的 html 文件,不支持远程资源。 +> - 不支持音视频播放; +> - 不支持横竖屏事件。 ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| ----------------- | ---------------- | ------------------------------------------ | ------------------------------------------------------------ | -| javaScriptAccess | boolean | true | 是否允许执行 JavaScript 脚本,默认允许执行。 | -| fileAccess | boolean | true | 启用或禁用 Web 中可通过 file 方式访问应用中的本地文件, 默认启用。 | -| onlineImageAccess | boolean | true | 是否允许从网络加载图片 资源(通过http和http访问的资源),默认允许访问。 | -| domStorageAccess | boolean | false | 设置是否开启DOM存储API权限,默认未开启,设置为true时,WebView能够使用DOM storageAPI。 | -| imageAccess | boolean | true | 设置是否允许自动加载图片资源,默认允许。 | -| mixedMode | MixedModeContent | MixedModeContent.MIXED_CONTENT_NEVER_ALLOW | 设置是否加载http和https混合内容,默认不允许加载http和https混合内容。 | -| zoomAccess | boolean | true | 设置是否支持使用屏幕控件或手势进行缩放,默认执行缩放。 | -| geolocationAccess | boolean | true | 是否允许访问地理位置, 默认允许。 | +| 名称 | 参数类型 | 默认值 | 描述 | +| ----------------- | --------- | -------------- | ---------------------------------------- | +| domStorageAccess | boolean | false | 设置是否开启DOM Storage API权限,默认未开启。 | +| fileAccess | boolean | true | 设置是否开启Web中通过FILE方式访问应用中的本地文件, 默认启用。 | +| geolocationAccess | boolean | true | 设置是否允许访问地理位置, 默认允许访问。 | +| imageAccess | boolean | true | 设置是否允许自动加载图片资源,默认允许。 | +| javaScriptAccess | boolean | true | 设置是否允许执行JavaScript脚本,默认允许执行。 | +| 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) **说明:** > -> 不支持通用属性。 -- MixedModeContent枚举说明 +> 通用属性仅支持width、height、padding、margin、border。 +- MixedMode枚举说明 - | 名称 | 描述 | - | -------------------------------- | ------------------------------------------------------------ | - | MIXED_CONTENT_NEVER_ALLOW | 不允许加载http和https混合内容。 | - | MIXED_CONTENT_ALWAYS_ALLOW | 允许加载http和https混合内容。 | - | MIXED_CONTENT_COMPATIBILITY_MODE | 混合内容兼容性模式,一些不安全的内容可能被安全来源加载,其他类型的内容将被阻止。 | + | 名称 | 描述 | + | ---------- | ---------------------------------------- | + | All | 允许加载HTTP和HTTPS混合内容。 | + | Compatible | 混合内容兼容性模式,一些不安全的内容可能被安全来源加载,其他类型的内容将被阻止。 | + | None | 不允许加载HTTP和HTTPS混合内容。 | ## 事件 -不支持通用事件。 +通用事件仅支持onFocus。 -| 名称 | 功能描述 | -| ------------------------------------------------------------ | ------------------------------------------------------------ | -| onPageEnd(callback: (event?: { url: string }) => void) |
网页加载结束时触发该回调。
url:Web 引擎返回的 URL。
网页加载时触发该回调。
url:Web 引擎返回的 URL。
下载开始时触发该回调。
url:Web引擎返回的下载URL。
userAgent:Web引擎返回的用户代理名称。
contentDisposition:Web引擎返回的响应头。
mimetype:Web引擎返回的mimetype信息。
contentLength:Web引擎返回的内容长度。
调用onGeolocationShow时发出的地理位置权限请求被取消后触发该回调。
| +| onGeolocationShow(callback: (event?: { origin: string, geolocation: JsGeolocation }) => void) |应用尝试使用地理位置时触发该回调,并向用户请求权限。
origin:尝试获取地理位置的Web内容的来源。
geolocation:用于请求地理位置权限。
网页加载时触发该回调。
url:Web引擎返回的URL。
网页加载结束时触发该回调。
url:Web引擎返回的URL。
网页加载进度变化时触发该回调。
newProgress:加载进度,取值范围为0到100的整数。
网页主页面标题更改时触发该回调。
title:标题内容。
调用onGeolocationShow()时发出的地理位置权限请求被取消后触发该回调。
开发者可以在该回调中实现隐藏相关UI界面的逻辑。
应用尝试使用地理位置时触发该回调,并向用户请求权限。
-origin:尝试获取地理位置的Web内容的来源。
-geolocation:用于请求地理位置权限。
网页主页面标题更改时触发该回调。
title:标题内容。
通知系统用户是否批准该应用使用地理位置权限。
-origin:尝试获取地理位置的Web内容的来源。
-allow:用户是否批准该应用使用地理位置权限。true: 允许访问,false: 不允许访问。
-retain:是否允许将地理位置权限状态保存到系统中。true: 允许,false: 不允许。
通知系统用户是否批准该应用使用地理位置权限。
origin:尝试获取地理位置的Web内容的来源。
allow:用户是否批准该应用使用地理位置权限。true: 允许访问,false: 不允许访问。
retain:是否允许将地理位置权限状态保存到系统中。true: 允许,false: 不允许。