!12895 资料文档描述优化

Merge pull request !12895 from wangkailong/want

zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md

@@ -14,7 +14,7 @@ import wantConstant from '@ohos.ability.wantConstant';
 
 ## wantConstant.Action
 
-want操作的常数。
+want操作的常数。用于表示要执行的通用操作。
 
 **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
 
@@ -57,13 +57,13 @@ want操作的常数。
 
 ## wantConstant.Entity
 
-want实体的常数。
+want实体的常数。用于表示目标Ability额外的类别信息。
 
 **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
 
 | 名称      | 值          | 说明     |
 | ------------ | ------------------ | ---------------------- |
-| ENTITY_DEFAULT                             | entity.system.default                    | 指示默认实体，如果未指定该实体，则使用该实体。        |
+| ENTITY_DEFAULT                             | entity.system.default                    | 指示默认实体，如果未指定实体，则使用该实体。        |
 | ENTITY_HOME                                | entity.system.home                       | 指示主屏幕实体。                                    |
 | ENTITY_VOICE                               | entity.system.voice                      | 表示语音交互实体。                                  |
 | ENTITY_BROWSABLE                           | entity.system.browsable                  | 指示浏览器类别。                                    |
@@ -72,7 +72,7 @@ want实体的常数。
 
 ## wantConstant.Flags
 
-Flags说明。
+Flags说明。用于表示处理Want的方式。
 
 **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
 

zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md

@@ -16,7 +16,7 @@ import Configuration from '@ohos.app.ability.Configuration'
 
   | 名称 | 类型 | 可读 | 可写 | 说明 |
 | -------- | -------- | -------- | -------- | -------- |
-| language | string | 是 | 是 | 表示应用程序的当前语言。 |
+| language | string | 是 | 是 | 表示应用程序的当前语言。例如：zh。 |
 | colorMode | [ColorMode](js-apis-app-ability-configurationConstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 |
 | direction | [Direction](js-apis-app-ability-configurationConstant.md#configurationconstantdirection) | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 |
 | screenDensity  | [ScreenDensity](js-apis-app-ability-configurationConstant.md#configurationconstantscreendensity) | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 |
@@ -40,7 +40,7 @@ import Configuration from '@ohos.app.ability.Configuration'
     }
   };
   try {
-    var callbackId = applicationContext.on("environment", envCallback);
+    let callbackId = applicationContext.on("environment", envCallback);
   } catch (paramError) {
     console.log("error: " + paramError.code + ", " + paramError.message);
   }

zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md

@@ -18,23 +18,23 @@ import Want from '@ohos.app.ability.Want';
 
 | 名称        | 类型                 | 必填 | 说明                                                         |
 | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
-| deviceId    | string               | 否   | 表示运行指定Ability的设备ID。                                |
-| bundleName   | string               | 否   | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
+| deviceId    | string               | 否   | 表示运行指定Ability的设备ID。如果未设置该字段，则表明指定本设备。                                |
+| bundleName   | string               | 否   | 表示Bundle名称。 |
 | abilityName  | string               | 否   | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
 | uri          | string               | 否   | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
 | type         | string               | 否   | 表示MIME type类型描述，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。   |
 | flags        | number               | 否   | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-app-ability-wantConstant.md#wantConstant.Flags)。 |
-| action      | string               | 否   | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。                           |
+| action      | string               | 否   | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。具体参考：[action说明](js-apis-app-ability-wantConstant.md#wantConstant.Action)。隐式Want定义及匹配规则参考：[显式Want与隐式Want匹配规则](application-models/explicit-implicit-want-mappings.md)。                           |
 | parameters   | {[key: string]: any} | 否   | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundleManager-bundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。                                       |
-| entities    | Array\<string>       | 否   | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。                                    |
+| entities    | Array\<string>       | 否   | 表示目标Ability额外的类别信息（如：浏览器、视频播放器）。在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。具体参考：[entity说明](js-apis-app-ability-wantConstant.md#wantConstant.Entity)。                                    |
 | moduleName | string | 否    | 表示待启动的Ability所属的模块（module）。 |
 
 **示例：**
 
-- 基础用法
+- 基础用法(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象)
 
   ```ts
-    var want = {
+    let want = {
         "deviceId": "", // deviceId为空表示本设备
         "bundleName": "com.extreme.test",
         "abilityName": "MainAbility",
@@ -46,7 +46,7 @@ import Want from '@ohos.app.ability.Want';
     })
   ```
 
-- 通过自定字段传递数据, 以下为当前支持类型。
+- 通过自定字段传递数据, 以下为当前支持类型。(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象)
 
     * 字符串（String）
         ```ts
@@ -110,13 +110,13 @@ import Want from '@ohos.app.ability.Want';
     * 文件描述符（FD）
         ```ts
             import fileio from '@ohos.fileio';
-            var fd;
+            let fd;
             try {
                 fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
             } catch(e) {
                 console.log("openSync fail:" + JSON.stringify(e));
             }
-            var want = {
+            let want = {
                 "deviceId": "", // deviceId为空表示本设备
                 "bundleName": "com.extreme.test",
                 "abilityName": "MainAbility",
@@ -131,6 +131,8 @@ import Want from '@ohos.app.ability.Want';
             })
         ```
 
+- 更多详细说明和示例请参见： [应用模型](../../application-models/Readme-CN.md)的信息传递载体Want
+
   <!--no_check-->
 
 

zh-cn/application-dev/reference/apis/js-apis-app-ability-wantConstant.md

@@ -14,7 +14,7 @@ import wantConstant from '@ohos.app.ability.wantConstant';
 
 ## wantConstant.Action
 
-want操作的常数。
+want操作的常数。用于表示要执行的通用操作。
 
 **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
 
@@ -56,7 +56,7 @@ want操作的常数。
 
 ## wantConstant.Entity
 
-want实体的常数。
+want实体的常数。用于表示目标Ability额外的类别信息。
 
 **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
 
@@ -71,7 +71,7 @@ want实体的常数。
 
 ## wantConstant.Flags
 
-Flags说明。
+Flags说明。用于表示处理Want的方式。
 
 **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
 

zh-cn/application-dev/reference/apis/js-apis-application-configuration.md

@@ -16,7 +16,7 @@ import Configuration from '@ohos.application.Configuration'
 
   | 名称 | 类型 | 可读 | 可写 | 说明 |
 | -------- | -------- | -------- | -------- | -------- |
-| language<sup>8+</sup> | string | 是 | 是 | 表示应用程序的当前语言。 |
+| language<sup>8+</sup> | string | 是 | 是 | 表示应用程序的当前语言。例如：zh。 |
 | colorMode<sup>8+</sup> | [ColorMode](js-apis-application-configurationConstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 |
 | direction<sup>9+</sup> | [Direction](js-apis-application-configurationConstant.md#configurationconstantdirection9) | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 |
 | screenDensity<sup>9+</sup>  | [ScreenDensity](js-apis-application-configurationConstant.md#configurationconstantscreendensity9) | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 |

zh-cn/application-dev/reference/apis/js-apis-application-want.md

@@ -18,23 +18,23 @@ import Want from '@ohos.application.Want';
 
 | 名称        | 类型                 | 必填 | 说明                                                         |
 | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
-| deviceId    | string               | 否   | 表示运行指定Ability的设备ID。                                |
-| bundleName   | string               | 否   | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
+| deviceId    | string               | 否   | 表示运行指定Ability的设备ID。如果未设置该字段，则表明指定本设备。                                |
+| bundleName   | string               | 否   | 表示Bundle名称。 |
 | abilityName  | string               | 否   | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
 | uri          | string               | 否   | 表示Uri描述。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
 | type         | string               | 否   | 表示MIME type类型描述，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。   |
 | flags        | number               | 否   | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#wantConstant.Flags)。 |
-| action      | string               | 否   | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。                           |
+| action      | string               | 否   | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。具体参考：[action说明](js-apis-app-ability-wantConstant.md#wantConstant.Action)。隐式Want定义及匹配规则参考：[显式Want与隐式Want匹配规则](application-models/explicit-implicit-want-mappings.md)。                           |
 | parameters   | {[key: string]: any} | 否   | 表示WantParams描述，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。                                       |
-| entities    | Array\<string>       | 否   | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。                                    |
+| entities    | Array\<string>       | 否   | 表示目标Ability额外的类别信息（如：浏览器、视频播放器）。在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。具体参考：[entity说明](js-apis-app-ability-wantConstant.md#wantConstant.Entity)。                                    |
 | moduleName<sup>9+</sup> | string | 否    | 表示待启动的Ability所属的模块（module）。 |
 
 **示例：**
 
-- 基础用法
+- 基础用法(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象)
 
   ```ts
-    var want = {
+    let want = {
         "deviceId": "", // deviceId为空表示本设备
         "bundleName": "com.extreme.test",
         "abilityName": "MainAbility",
@@ -46,7 +46,7 @@ import Want from '@ohos.application.Want';
     })
   ```
 
-- 通过自定字段传递数据, 以下为当前支持类型。
+- 通过自定字段传递数据, 以下为当前支持类型。(在UIAbility对象中调用，其中示例中的context为UIAbility的上下文对象)
 
     * 字符串（String）
         ```ts
@@ -110,13 +110,13 @@ import Want from '@ohos.application.Want';
     * 文件描述符（FD）
         ```ts
             import fileio from '@ohos.fileio';
-            var fd;
+            let fd;
             try {
                 fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
             } catch(e) {
                 console.log("openSync fail:" + JSON.stringify(e));
             }
-            var want = {
+            let want = {
                 "deviceId": "", // deviceId为空表示本设备
                 "bundleName": "com.extreme.test",
                 "abilityName": "MainAbility",
@@ -131,4 +131,6 @@ import Want from '@ohos.application.Want';
             })
         ```
 
+- 更多详细说明和示例请参见： [应用模型](../../application-models/Readme-CN.md)的信息传递载体Want
+
   <!--no_check-->
\ No newline at end of file

zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md

@@ -10,15 +10,15 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传
 
 | 名称        | 类型                 | 必填 | 说明                                                         |
 | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
-| deviceId    | string               | 否   | 表示运行指定Ability的设备ID。                                |
-| bundleName   | string               | 否   | 表示Bundle名称。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
+| deviceId    | string               | 否   | 表示运行指定Ability的设备ID。如果未设置该字段，则表明指定本设备。                                |
+| bundleName   | string               | 否   | 表示Bundle名称。 |
 | abilityName  | string               | 否   | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
 | uri          | string               | 否   | 表示Uri。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
 | type         | string               | 否   | 表示MIME type类型，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。   |
 | flags        | number               | 否   | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-ability-wantConstant.md#wantConstant.Flags)。 |
-| action      | string               | 否   | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。                           |
+| action      | string               | 否   | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。具体参考：[action说明](js-apis-app-ability-wantConstant.md#wantConstant.Action)。隐式Want定义及匹配规则参考：[显式Want与隐式Want匹配规则](application-models/explicit-implicit-want-mappings.md)。                           |
 | parameters   | {[key: string]: any} | 否   | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。                                       |
-| entities    | Array\<string>       | 否   | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。                                    |
+| entities    | Array\<string>       | 否   | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。具体参考：[entity说明](js-apis-app-ability-wantConstant.md#wantConstant.Entity)。                                    |
 | moduleName<sup>9+</sup> | string | 否    | 表示待启动的Ability所属的模块（module）。 |
 
 **示例：**

zh-cn/application-dev/reference/apis/js-apis-system-configuration.md

@@ -10,8 +10,8 @@
 ## 导入模块
 
 
-```
-import configuration from '@system.configuration';
+```ts
+import Configuration from '@system.configuration';
 ```