From 8c228b3568e51966394fa9bde5176922cc800079 Mon Sep 17 00:00:00 2001 From: xiongjun_gitee Date: Wed, 17 Aug 2022 17:11:13 +0800 Subject: [PATCH] updata zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md Signed-off-by: xiongjun_gitee --- .../arkui-ts/ts-basic-components-web.md | 267 ++++++++++++++++++ 1 file changed, 267 insertions(+) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md index 7b4760eab4..ad87e9eb4b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md @@ -3059,6 +3059,273 @@ static saveHttpAuthCredentials(host: string, realm: string, username: string, pa } ``` +## GeolocationPermissions9+ + +web组件地理位置权限管理对象。 + +### allowGeolocation9+ + +static allowGeolocation(origin: string): void + +允许指定来源使用地理位置API。 + +**参数：** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| -------- | -------- | ---- | ----- | ------------- | +| origin | string | 是 | - | 指定源的字符串索引。 | + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + origin: string = "file:///"; + build() { + Column() { + Button('allowGeolocation') + .onClick(() => { + web.GeolocationPermissions.allowGeolocation(this.origin); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + +### deleteGeolocation9+ + +static deleteGeolocation(origin: string): void + +清除指定来源的地理位置权限状态。 + +**参数：** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| -------- | -------- | ---- | ----- | ------------- | +| origin | string | 是 | - | 指定源的字符串索引。 | + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + origin: string = "file:///"; + build() { + Column() { + Button('deleteGeolocation') + .onClick(() => { + web.GeolocationPermissions.deleteGeolocation(this.origin); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + +### deleteAllGeolocation9+ + +static deleteAllGeolocation(): void + +清除所有来源的地理位置权限状态。 + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + build() { + Column() { + Button('deleteAllGeolocation') + .onClick(() => { + web.GeolocationPermissions.deleteAllGeolocation(); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + +### getAccessibleGeolocation9+ + +static getAccessibleGeolocation(origin: string, callback: AsyncCallback\): void + +以回调方式异步获取指定源的地理位置权限状态。 + +**参数：** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| -------- | -------- | ---- | ----- | ------------- | +| origin | string | 是 | - | 指定源的字符串索引。 | +| callback | AsyncCallback\ | 是 | - | 返回指定源的地理位置权限状态，获取成功，true表示已授权，false表示拒绝访问；获取失败，表示不存在指定源的权限状态。 | + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + origin: string = "file:///"; + build() { + Column() { + Button('getAccessibleGeolocationAsync') + .onClick(() => { + web.GeolocationPermissions.getAccessibleGeolocation(this.origin, (error, result) => { + if (error) { + console.log('getAccessibleGeolocationAsync error: ' + error); + return; + } + console.log('getAccessibleGeolocationAsync result: ' + result); + }); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + +### getAccessibleGeolocation9+ + +static getAccessibleGeolocation(origin: string): Promise\ + +以Promise方式异步获取指定源的地理位置权限状态。 + +**参数：** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| -------- | -------- | ---- | ----- | ------------- | +| origin | string | 是 | - | 指定源的字符串索引。 | + +**返回值：** + +| 类型 | 说明 | +| ------------------ | ------------------------------------ | +| Promise\ | Promise实例，用于获取指定源的权限状态，获取成功，true表示已授权，false表示拒绝访问；获取失败，表示不存在指定源的权限状态。 | + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + origin: string = "file:///"; + build() { + Column() { + Button('getAccessibleGeolocationPromise') + .onClick(() => { + web.GeolocationPermissions.getAccessibleGeolocation(this.origin).then(result => { + console.log('getAccessibleGeolocationPromise result: ' + result); + }).catch(error => { + console.log('getAccessibleGeolocationPromise error: ' + error); + }); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + +### getStoredGeolocation9+ + +static getStoredGeolocation(callback: AsyncCallback\\>): void + +以回调方式异步获取已存储地理位置权限状态的所有源。 + +**参数：** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| -------- | -------- | ---- | ----- | ------------- | +| callback | AsyncCallback\\> | 是 | - | 返回已存储地理位置权限状态的所有源。 | + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + build() { + Column() { + Button('getStoredGeolocationAsync') + .onClick(() => { + web.GeolocationPermissions.getStoredGeolocation((error, origins) => { + if (error) { + console.log('getStoredGeolocationAsync error: ' + error); + return; + } + let origins_str: string = ""; + for (let i = 0; i < origins.length; i++) { + origins_str = origins_str + origins[i] + " "; + } + console.log('getStoredGeolocationAsync origins: ' + origins_str); + }); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + +### getStoredGeolocation9+ + +static getStoredGeolocation(): Promise\\> + +以Promise方式异步获取已存储地理位置权限状态的所有源。 + +**参数：** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| -------- | -------- | ---- | ----- | ------------- | +| callback | AsyncCallback\\> | 是 | - | 返回已存储地理位置权限状态的所有源。 | + +**返回值：** + +| 类型 | 说明 | +| -------------------------- | ------------------------------------ | +| Promise\\> | Promise实例，用于获取已存储地理位置权限状态的所有源。 | + +**示例：** + ```ts + // xxx.ets + import web from '@ohos.web'; + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + build() { + Column() { + Button('getStoredGeolocationPromise') + .onClick(() => { + web.GeolocationPermissions.getStoredGeolocation().then(origins => { + let origins_str: string = ""; + for (let i = 0; i < origins.length; i++) { + origins_str = origins_str + origins[i] + " "; + } + console.log('getStoredGeolocationPromise origins: ' + origins_str); + }).catch(error => { + console.log('getStoredGeolocationPromise error: ' + error); + }); + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } + } + ``` + ## WebStorage9+ 通过WebStorage可管理Web SQL数据库接口和HTML5 Web存储接口，每个应用中的所有Web组件共享一个WebStorage。 ### deleteAllData9+ -- GitLab