From 32cd183c7ffc2ab4d306a48d364d91aadb58cda4 Mon Sep 17 00:00:00 2001 From: xuchangzhou Date: Sat, 22 Jan 2022 11:57:12 +0800 Subject: [PATCH 1/2] update js-apis-settings.md Signed-off-by: xuchangzhou --- .../reference/apis/js-apis-settings.md | 44 ++++++++----------- 1 file changed, 19 insertions(+), 25 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-settings.md b/zh-cn/application-dev/reference/apis/js-apis-settings.md index 2e97fdb2507..e1b516f3c2b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis/js-apis-settings.md @@ -28,7 +28,7 @@ getUri(name: string): string - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | name | string | 是 | 数据项的名称。 | + | name | string | 是 | 数据项的名称。数据项名称分为以下两种：
| - 返回值： | 类型 | 说明 | @@ -52,8 +52,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | - | name | string | 是 | 数据项的名称。 | - | defValue | string | 是 | 默认值。 | + | name | string | 是 | 数据项的名称。数据项名称分为以下两种：
| + | defValue | string | 是 | 默认值。由开发者设置，当未从数据库中查询到该数据时，则返回该默认值。 | - 返回值： | 类型 | 说明 | @@ -62,17 +62,13 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): - 示例： ``` - Button(`register and unregister an observer`) - .onClick(()=>{ - // 获取数据项的URI - let urivar = settings.getUri(this.dataName); - // 获取DataAbilityHelper对象 - let helper = featureAbility.acquireDataAbilityHelper(urivar); - // 注册观察者，on方法第一个参数写"dataChange"，第二个参数为URI，第三个参数为当该URI指向的数据发生改变时触发的回调函数 - helper.on("dataChange", urivar, (err) => { - console.log('observer reveive notifychange on success data : ' + JSON.stringify(err)) - this.value = settings.getValue(helper, this.dataName, 'this is default value') - }) + import featureAbility from '@ohos.featureAbility'; + + //获取数据项亮度的值（该数据项在数据库中已存在） + let brightness = 'settings.screen.brightness'; + let uri = settings.getUri(brightness); + let helper = featureAbility.acquireDataAbilityHelper(uri); + let value = settings.getValue(helper, brightness, '10'); ``` @@ -81,6 +77,7 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean 设置数据项的值。 +如果数据库中已经存在该数据项，则setValue方法将更新该数据项的值；如果数据库中尚未存在该数据项，则setValue方法将向数据库中插入该数据项。 使用此方法需获取ohos.permission.WRITE_SYSTEM_SETTING权限。 @@ -88,7 +85,7 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boo | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | - | name | string | 是 | 数据项的名称。 | + | name | string | 是 | 数据项的名称。数据项名称分为以下两种：
| | value | string | 是 | 数据项的具体数值。 | - 返回值： @@ -98,14 +95,11 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boo - 示例： ``` - Button(`setValue`) - .onClick(()=>{ - // 获取数据项的URI - let urivar = settings.getUri(this.dataName); - // 获取DataAbilityHelper对象 - let helper = featureAbility.acquireDataAbilityHelper(urivar); - let valueTest = 'valueTest'; - // 更新数据库中的值 - settings.setValue(helper, this.dataName, valueTest) - }) + import featureAbility from '@ohos.featureAbility'; + + //更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） + let brightness = 'settings.screen.brightness'; + let uri = settings.getUri(brightness); + let helper = featureAbility.acquireDataAbilityHelper(uri); + let ret = settings.setValue(helper, brightness, '100'); ``` -- Gitee From 3ff1e4812a140e304f0a93b9aa8dbb4dd1834dc8 Mon Sep 17 00:00:00 2001 From: xuchangzhou Date: Sat, 22 Jan 2022 06:41:12 +0000 Subject: [PATCH 2/2] update zh-cn/application-dev/reference/apis/js-apis-settings.md. --- zh-cn/application-dev/reference/apis/js-apis-settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-settings.md b/zh-cn/application-dev/reference/apis/js-apis-settings.md index e1b516f3c2b..2f8fd145e1c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis/js-apis-settings.md @@ -38,7 +38,7 @@ getUri(name: string): string - 示例： ``` // 获取数据项的URI - let urivar = settings.getUri(this.dataName); + let urivar = settings.getUri('settings.screen.brightness'); ``` -- Gitee