未验证 提交 32078c67 编写于 作者: O openharmony_ci 提交者: Gitee

!7377 更新ts-basic-components-web.md,新增onPermissionRequest

Merge pull request !7377 from xiongjun_gitee/master
......@@ -1186,6 +1186,45 @@ onHttpAuthRequest(callback: (event?: { handler: HttpAuthHandler, host: string, r
}
}
```
### onPermissionRequest<sup>9+</sup>
onPermissionRequest(callback: (event?: { request: PermissionRequest }) => void)
通知收到获取权限请求。
**参数:**
| 参数名 | 参数类型 | 参数描述 |
| ------- | ------------------------------------ | ---------------- |
| request | [PermissionRequest](#permissionrequest9) | 通知Web组件用户操作行为。 |
**示例:**
```ts
// xxx.ets
@Entry
@Component
struct WebComponent {
controller:WebController = new WebController();
build() {
Column() {
Web({ src:'www.example.com', controller:this.controller })
.onPermissionRequest((event) => {
AlertDialog.show({
title: 'title',
message: 'text',
confirm: {
value: 'onConfirm',
action: () => {
event.request.grant(event.request.getAccessibleResource());
}
},
cancel: () => {
event.request.deny();
}
})
})
}
}
```
## ConsoleMessage
......@@ -1595,6 +1634,52 @@ isHttpAuthInfoSaved(): boolean
| ------- | ------------------------- |
| boolean | 存在密码认证成功返回true,其他返回false。 |
## PermissionRequest<sup>9+</sup>
Web组件返回授权或拒绝权限功能的对象。示例代码参考[onPermissionRequest事件](#onpermissionrequest9)
### deny<sup>9+</sup>
deny(): void
拒绝网页所请求的权限。
### getOrigin<sup>9+</sup>
getOrigin(): string
获取网页来源。
**返回值:**
| 类型 | 说明 |
| ------- | --------------------- |
| string | 当前请求权限网页的来源。 |
### getAccessibleResource<sup>9+</sup>
getAccessibleResource(): Array\<string\>
获取网页所请求的权限资源列表,资源列表类型参考[ProtectedResourceType](#protectedresourcetype9枚举说明)
**返回值:**
| 类型 | 说明 |
| --------------- | ----------------------- |
| Array\<string\> | 网页所请求的权限资源列表。 |
### grant<sup>9+</sup>
grant(resources: Array\<string\>): void
对网页访问的给定权限进行授权。
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| --------- | --------------- | ---- | ----- | ---------------------- |
| resources | Array\<string\> | 是 | - | 网页所请求的权限资源列表。|
## WebController
通过WebController可以控制Web组件各种行为。一个WebController对象只能控制一个Web组件,且必须在Web组件和WebController绑定后,才能调用WebController上的方法。
......@@ -3076,4 +3161,10 @@ onRenderExited接口返回的渲染进程退出的具体原因。
| HttpAnchorImg | 带有超链接的图片,其中超链接的src为http。 |
| Img | HTML::img标签。 |
| Map | 地理地址。 |
| Unknown | 未知内容。 |
\ No newline at end of file
| Unknown | 未知内容。 |
## ProtectedResourceType<sup>9+</sup>枚举说明
| 名称 | 描述 | 备注 |
| --------- | -------------- | -------------- |
| MidiSysex | MIDI SYSEX资源。| 目前仅支持权限事件上报,MIDI设备的使用还未支持。|
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册