!11075 翻译完成 10485/10619/10333/11071/10006

Merge pull request !11075 from ester.zhou/C3-1027

en/application-dev/Readme-EN.md

@@ -8,14 +8,15 @@
 - Quick Start
     - Getting Started
         - [Preparations](quick-start/start-overview.md)
-        - [Getting Started with eTS in Stage Model](quick-start/start-with-ets-stage.md)
-        - [Getting Started with eTS in FA Model](quick-start/start-with-ets-fa.md)
+        - [Getting Started with ArkTS in Stage Model](quick-start/start-with-ets-stage.md)
+        - [Getting Started with ArkTS in FA Model](quick-start/start-with-ets-fa.md)
         - [Getting Started with JavaScript in FA Model](quick-start/start-with-js-fa.md)
     - Development Fundamentals
         - [Application Package Structure Configuration File (FA Model)](quick-start/package-structure.md)
         - [Application Package Structure Configuration File (Stage Model)](quick-start/stage-structure.md)
         - [SysCap](quick-start/syscap.md)
         - [HarmonyAppProvision Configuration File](quick-start/app-provision-structure.md)
+        - [Resource Categories and Access](quick-start/resource-categories-and-access.md)
 - Development
     - [Ability Development](ability/Readme-EN.md)
     - [UI Development](ui/Readme-EN.md)

en/application-dev/quick-start/Readme-EN.md

@@ -2,11 +2,13 @@
 
 - Getting Started
   - [Preparations](start-overview.md)
-  - [Getting Started with eTS in Stage Model](start-with-ets-stage.md)
-  - [Getting Started with eTS in FA Model](start-with-ets-fa.md)
+  - [Getting Started with ArkTS in Stage Model](start-with-ets-stage.md)
+  - [Getting Started with ArkTS in FA Model](start-with-ets-fa.md)
   - [Getting Started with JavaScript in FA Model](start-with-js-fa.md)
 - Development Fundamentals
   - [Application Package Structure Configuration File (FA Model)](package-structure.md)
   - [Application Package Structure Configuration File (Stage Model)](stage-structure.md)
   - [SysCap](syscap.md)
   - [HarmonyAppProvision Configuration File](app-provision-structure.md)
+  - [Resource Categories and Access](resource-categories-and-access.md)
+

en/application-dev/quick-start/resource-categories-and-access.md

+# Resource Categories and Access
+
+## Resource Categories
+
+Resource files used during application development must be stored in specified directories for management.
+
+### resources Directory
+
+The **resources** directory consists of three types of sub-directories: the **base** sub-directory, qualifiers sub-directories, and the **rawfile** sub-directory. The common resource files used across projects in the stage model are stored in the **resources** directory under **AppScope**.
+
+  Example of the **resources** directory:
+
+```
+resources
+|---base  // Default directory
+|   |---element
+|   |   |---string.json
+|   |---media
+|   |   |---icon.png
+|---en_GB-vertical-car-mdpi // Example of a qualifiers sub-directory, which needs to be created on your own  
+|   |---element
+|   |   |---string.json
+|   |---media
+|   |   |---icon.png
+|---rawfile
+```
+
+**Table 1** Classification of the resources directory
+
+| Category  | base Sub-directory                          | Qualifiers Sub-directory                                   | rawfile Sub-directory                               |
+| ---- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
+| Structure| The **base** sub-directory is a default directory. If no qualifiers sub-directories in the **resources** directory of the application match the device status, the resource file in the **base** sub-directory will be automatically referenced.<br>Resource group sub-directories are located at the second level of sub-directories to store basic elements such as strings, colors, and boolean values, as well as resource files such as media, animations, and layouts. For details, see [Resource Group Sub-directories](#resource-group-sub-directories).| You need to create qualifiers sub-directories on your own. Each directory name consists of one or more qualifiers that represent the application scenarios or device characteristics. For details, see [Qualifiers Directory](#qualifiers-directory).<br>Resource group sub-directories are located at the second level of sub-directories to store basic elements such as strings, colors, and boolean values, as well as resource files such as media, animations, and layouts. For details, see [Resource Group Sub-directories](#resource-group-sub-directories).| You can create multiple levels of sub-directories with custom directory names. They can be used to store various resource files.<br>However, resource files in the **rawfile** sub-directory will not be matched based on the device status.|
+| Compilation| Resource files in the sub-directory are compiled into binary files, and each resource file is assigned an ID.           | Resource files in the sub-directory are compiled into binary files, and each resource file is assigned an ID.           | Resource files in the sub-directory are directly packed into the application without being compiled, and no IDs will be assigned to the resource files.   |
+| Reference| Resource files in the sub-directory are referenced based on the resource type and resource name.           | Resource files in the sub-directory are referenced based on the resource type and resource name.           | Resource files in the sub-directory are referenced based on the file path and file name.                        |
+
+
+### Qualifiers Sub-directories
+
+The name of a qualifiers sub-directory consists of one or more qualifiers that represent the application scenarios or device characteristics, covering the mobile country code (MCC), mobile network code (MNC), language, script, country or region, screen orientation, device type, night mode, and screen density. The qualifiers are separated using underscores (\_) or hyphens (\-). Before creating a qualifiers sub-directory, familiarize yourself with the directory naming conventions and the rules for matching qualifiers sub-directories and the device status.
+
+**Naming Conventions for Qualifiers Sub-directories**
+
+- Qualifiers are ordered in the following sequence: **\_MCC_MNC-language_script_country/region-orientation-device-color mode-density**. You can select one or multiple qualifiers to name your sub-directory based on your application scenarios and device characteristics.
+
+- Separation between qualifiers: The language, script, and country/region qualifiers are separated using underscores (\_); the MNC and MCC qualifiers are also separated using underscores (\_); other qualifiers are separated using hyphens (\-). For example, **zh_Hant_CN** and **zh_CN-car-ldpi**.
+
+- Value range of qualifiers: The value of each qualifier must meet the requirements specified in the following table. Otherwise, the resource files in the resources directory cannot be matched.
+
+**Table 2** Requirements for qualifier values
+
+| Qualifier Type      | Description and Value Range                                 |
+| ----------- | ---------------------------------------- |
+| MCC&MNC| Indicates the MCC and MNC, which are obtained from the network where the device is registered. The MCC can be either followed by the MNC with an underscore (\_) in between or be used independently. For example, **mcc460** indicates China, and **mcc460\_mnc00** indicates China\_China Mobile.<br>For details about the value range, refer to **ITU-T E.212** (the international identification plan for public networks and subscriptions).|
+| Language         | Indicates the language used by the device. The value consists of two or three lowercase letters. For example, **zh** indicates Chinese, **en** indicates English, and **mai** indicates Maithili.<br>For details about the value range, refer to **ISO 639** (codes for the representation of names of languages).|
+| Text         | Indicates the script type used by the device. The value starts with one uppercase letter followed by three lowercase letters. For example, **Hans** indicates simplified Chinese, and **Hant** indicates traditional Chinese.<br>For details about the value range, refer to **ISO 15924** (codes for the representation of names of scripts).|
+| Country/Region      | Indicates the country or region where the user is located. The value consists of two or three uppercase letters or three digits. For example, **CN** indicates China, and **GB** indicates the United Kingdom.<br>For details about the value range, refer to **ISO 3166-1** (codes for the representation of names of countries and their subdivisions).|
+| Screen orientation        | Indicates the screen orientation of the device. The value can be:<br>- **vertical**: portrait orientation<br>- **horizontal**: landscape orientation|
+| Device type       | Indicates the device type. The value can be:<br>- **car**: head unit<br>- **tv**: smart TV<br>- **wearable**: smart wearable|
+| Color mode       | Indicates the color mode of the device. The value can be:<br>- **dark**: dark mode<br>- **light**: light mode|
+| Screen density       | Indicates the screen density of the device, in dpi. The value can be:<br>- **sdpi**: screen density with small-scale dots per inch (SDPI). This value is applicable for devices with a DPI range of (0, 120].<br>- **mdpi**: medium-scale screen density (Medium-scale Dots Per Inch), applicable to DPI whose value is (120,  160] device.<br>- **ldpi**: screen density with large-scale dots per inch (LDPI). This value is applicable for devices with a DPI range of (160, 240].<br>- **xldpi**: screen density with extra-large-scale dots per inch (XLDPI). This value is applicable for devices with a DPI range of (240, 320].<br>- **xxldpi**: screen density with extra-extra-large-scale dots per inch (XXLDPI). This value is applicable for devices with a DPI range of (320, 480].<br>- **xxxldpi**: screen density with extra-extra-extra-large-scale dots per inch (XXXLDPI). This value is applicable for devices with a DPI range of (480, 640].|
+
+**Rules for Matching Qualifiers Sub-directories and Device Resources**
+
+- Qualifiers are matched with the device resources in the following priorities: MCC&MNC > locale (options: language, language_script, language_country/region, and language_script_country/region) > screen orientation > device type > color mode > screen density.
+
+- If the qualifiers sub-directories contain the **MCC, MNC, language, script, screen orientation, device type, and color mode** qualifiers, their values must be consistent with the current device status so that the sub-directories can be used for matching the device resources. For example, the qualifiers sub-directory **zh_CN-car-ldpi** cannot be used for matching the resource files labeled **en_US**.
+
+
+### Resource Group Sub-directories
+
+You can create resource group sub-directories (including element, media, and profile) in the **base** and qualifiers sub-directories to store resource files of specific types.
+
+
+  **Table 3** Resource group sub-directories
+
+| Resource Group Sub-directory  | Description                                    | Resource File                                    |
+| ------- | ---------------------------------------- | ---------------------------------------- |
+| element | Indicates element resources. Each type of data is represented by a JSON file. The options are as follows:<br>- **boolean**: boolean data<br>- **color**: color data<br>- **float**: floating-point data<br>- **intarray**: array of integers<br>- **integer**: integer data<br>- **pattern**: pattern data<br>- **plural**: plural form data<br>- **strarray**: array of strings<br>- **string**: string data| It is recommended that files in the **element** sub-directory be named the same as the following files, each of which can contain only data of the same type:<br>- boolean.json<br>- color.json<br>- float.json<br>- intarray.json<br>- integer.json<br>- pattern.json<br>- plural.json<br>- strarray.json<br>- string.json |
+| media   | Indicates media resources, including non-text files such as images, audios, and videos.             | The file name can be customized, for example, **icon.png**.                    |
+| rawfile | Indicates other types of files, which are stored in their raw formats after the application is built as an HAP file. They will not be integrated into the **resources.index** file.| The file name can be customized.                                |
+
+**Media Resource Types**
+
+**Table 4** Image resource types
+
+| Format  | File Name Extension|
+| ---- | ----- |
+| JPEG | .jpg  |
+| PNG  | .png  |
+| GIF  | .gif  |
+| SVG  | .svg  |
+| WEBP | .webp |
+| BMP  | .bmp  |
+
+**Table 5** Audio and video resource types
+
+| Format                                  | File Name Extension        |
+| ------------------------------------ | --------------- |
+| H.263                                | .3gp <br>.mp4   |
+| H.264 AVC <br> Baseline Profile (BP) | .3gp <br>.mp4   |
+| MPEG-4 SP                            | .3gp            |
+| VP8                                  | .webm <br> .mkv |
+
+**Resource File Examples**
+
+The content of the **color.json** file is as follows:
+
+
+```json
+{
+    "color": [
+        {
+            "name": "color_hello",
+            "value": "#ffff0000"
+        },
+        {
+            "name": "color_world",
+            "value": "#ff0000ff"
+        }
+    ]
+}
+```
+
+The content of the **float.json** file is as follows:
+
+
+```json
+{
+    "float":[
+        {
+            "name":"font_hello",
+            "value":"28.0fp"
+        },
+	{
+            "name":"font_world",
+            "value":"20.0fp"
+        }
+    ]
+}
+```
+
+The content of the **string.json** file is as follows:
+
+
+```json
+{
+    "string":[
+        {
+            "name":"string_hello",
+            "value":"Hello"
+        },
+	{
+            "name":"string_world",
+            "value":"World"
+        },
+	{
+            "name":"message_arrive",
+            "value":"We will arrive at %s."
+        }
+    ]
+}
+```
+
+The content of the **plural.json** file is as follows:
+
+
+```json
+{
+    "plural":[
+        {
+            "name":"eat_apple",
+            "value":[
+                {
+                    "quantity":"one",
+                    "value":"%d apple"
+                },
+                {
+                    "quantity":"other",
+                    "value":"%d apples"
+                }
+            ]
+        }
+    ]
+}
+```
+
+## Resource Access
+
+### Application Resources
+
+**Creating a Resource File**
+
+You can create a sub-directory and its files under the **resources** directory based on the preceding descriptions of the qualifiers sub-directories and resource group sub-directories.
+
+DevEco Studio provides a wizard for you to create resource directories and resource files.
+
+- Creating a Resource Directory and Resource File
+
+  Right-click the **resources** directory and choose **New > Resource File**.
+
+  If no qualifier is selected, the file is created in a resource type sub-directory under **base**. If one or more qualifiers are selected, the system automatically generates a sub-directory and creates the file in this sub-directory.
+
+  The created sub-directory is automatically named in the format of **Qualifiers.Resource type**. For example, if you create a sub-directory by setting **Orientation** to **Vertical** and **Resource type** to **Graphic**, the system automatically generates a sub-directory named **vertical.graphic**.
+
+  ![create-resource-file-1](figures/create-resource-file-1.png)
+
+- Creating a Resource Directory
+
+  Right-click the **resources** directory and choose **New > Resource Directory**. This operation creates a sub-directory only.
+
+  Select a resource group type and set qualifiers. Then the system automatically generates the sub-directory name. The sub-directory is automatically named in the format of **Qualifiers.Resource group**. For example, if you create a sub-directory by setting **Orientation** to **Vertical** and **Resource type** to **Graphic**, the system automatically generates a sub-directory named **vertical.graphic**.
+
+  ![create-resource-file-2](figures/create-resource-file-2.png)
+
+- Creating a Resource File
+
+  Right-click a sub-directory under **resources** and choose **New > *XXX* Resource File**. This operation creates a resource file under this sub-directory.
+
+  For example, you can create an element resource file in the **element** sub-directory.
+
+  ![create-resource-file-3](figures/create-resource-file-3.png)
+
+**Accessing Application Resources**
+
+To reference an application resource in a project, use the **"$r('app.type.name')"** format. **app** indicates the resource defined in the **resources** directory of the application. **type** indicates the resource type (or the location where the resource is stored). The value can be **color**, **float**, **string**, **plural**, or **media**. **name** indicates the resource name, which you set when defining the resource.
+
+When referencing resources in the **rawfile** sub-directory, use the **"$rawfile('filename')"** format. Wherein, **filename** indicates the relative path of a file in the **rawfile** directory, which must contain the file name extension in the file name and cannot start with a slash (/).
+
+> **NOTE**
+> 
+> Resource descriptors accept only strings, such as **'app.type.name'**, and cannot be combined.
+>
+> The return value of **$r** is a **Resource** object. You can obtain the corresponding string by using the [getStringValue](../reference/apis/js-apis-resource-manager.md#getstringvalue9) API.
+
+In the **.ets** file, you can use the resources defined in the **resources** directory.
+
+```ts
+Text($r('app.string.string_hello'))
+    .fontColor($r('app.color.color_hello'))
+    .fontSize($r('app.float.font_hello'))
+}
+
+Text($r('app.string.string_world'))
+    .fontColor($r('app.color.color_world'))
+    .fontSize($r('app.float.font_world'))
+}
+
+Text($r('app.string.message_arrive', "five of the clock")) // Reference string resources. The second parameter of $r is used to replace %s.
+    .fontColor($r('app.color.color_hello'))
+    .fontSize($r('app.float.font_hello'))
+}
+
+Text($r('app.plural.eat_apple', 5, 5))       // Reference plural resources. The first parameter indicates the plural resource, the second parameter indicates the number of plural resources, and the third parameter indicates the substitute of %d.
+    .fontColor($r('app.color.color_world'))
+    .fontSize($r('app.float.font_world'))
+}
+
+Image($r('app.media.my_background_image'))  // Reference media resources.
+
+Image($rawfile('test.png'))                 // Reference an image in the rawfile directory.
+
+Image($rawfile('newDir/newTest.png'))       // Reference an image in the rawfile directory.
+```
+
+### System Resources
+
+System resources include colors, rounded corners, fonts, spacing, character strings, and images. By using system resources, you can develop different applications with the same visual style.
+
+
+To reference a system resource, use the **"$r('sys.type.resource_id')"** format. Wherein: **sys** indicates a system resource; **type** indicates the resource type, which can be **color**, **float**, **string**, or **media**; **resource_id** indicates the resource ID.
+
+```ts
+Text('Hello')
+    .fontColor($r('sys.color.ohos_id_color_emphasize'))
+    .fontSize($r('sys.float.ohos_id_text_size_headline1'))
+    .fontFamily($r('sys.string.ohos_id_text_font_family_medium'))
+    .backgroundColor($r('sys.color.ohos_id_color_palette_aux1'))
+Image($r('sys.media.ohos_app_icon'))
+    .border({color: $r('sys.color.ohos_id_color_palette_aux1'), radius: $r('sys.float.ohos_id_corner_radius_button'), width: 2})
+    .margin({top: $r('sys.float.ohos_id_elements_margin_horizontal_m'), bottom: $r('sys.float.ohos_id_elements_margin_horizontal_l')})
+    .height(200)
+    .width(300)
+```

en/application-dev/quick-start/start-overview.md

@@ -16,11 +16,11 @@ Before you begin, there are two basic concepts that will help you better underst
 
 OpenHarmony provides a UI development framework, known as ArkUI. ArkUI provides a full range of capabilities you may need for application UI development, ranging from components to layout calculation, animation, UI interaction, and drawing capabilities.
 
-ArkUI comes with two development paradigms: JavaScript-based web-like development paradigm (web-like development paradigm for short) and TypeScript-based declarative development paradigm (declarative development paradigm for short). You can choose whichever development paradigm that aligns with your practice.
+ArkUI comes with two development paradigms: ArkTS-based declarative development paradigm (declarative development paradigm for short) and JavaScript-compatible web-like development paradigm (web-like development paradigm for short). You can choose whichever development paradigm that aligns with your practice.
 
 | **Development Paradigm**| **Programming Language**| **UI Update Mode**| **Applicable To**| **Intended Audience**|
 | -------- | -------- | -------- | -------- | -------- |
-| Declarative development paradigm| Extended TypeScript (eTS)| Data-driven| Applications involving technological sophistication and teamwork| Mobile application and system application developers|
+| Declarative development paradigm| ArkTS| Data-driven| Applications involving technological sophistication and teamwork| Mobile application and system application developers|
 | Web-like development paradigm| JavaScript| Data-driven| Applications and service widgets with simple UIs| Frontend web developers|
 
 For more details, see [UI Development](../ui/arkui-overview.md).
@@ -36,7 +36,7 @@ The ability framework model has two forms:
 
 - **Stage model**: introduced since API version 9. For details, see [Stage Model Overview](../ability/stage-brief.md).
 
-The project directory structure of the FA model is different from that of the stage model. The stage model only works with the eTS programming language.
+The project directory structure of the FA model is different from that of the stage model. The stage model only works with the ArkTS programming language.
 
 For details about the differences between the FA model and stage model, see [Ability Framework Overview](../ability/ability-brief.md).
 
@@ -49,4 +49,4 @@ This document provides an ability with two pages. For more information about abi
 
 2. Install DevEco Studio and configure the development environment. For details, see [Setting Up the Development Environment](https://developer.harmonyos.com/en/docs/documentation/doc-guides/ohos-setting-up-environment-0000001263160443).
 
-When you are done, follow the instructions in [Getting Started with eTS in Stage Model](start-with-ets-stage.md), [Getting Started with eTS in FA Model](start-with-ets-fa.md), and [Getting Started with JavaScript in FA Model](start-with-js-fa.md).
+When you are done, follow the instructions in [Getting Started with ArkTS in Stage Model](start-with-ets-stage.md), [Getting Started with ArkTS in FA Model](start-with-ets-fa.md), and [Getting Started with JavaScript in FA Model](start-with-js-fa.md).

en/application-dev/quick-start/start-with-ets-fa.md

-# Getting Started with eTS in FA Model
+# Getting Started with ArkTS in FA Model
 
 
 >  **NOTE**
 >
->  To use eTS, your DevEco Studio must be V3.0.0.601 Beta1 or later.
+>  To use ArkTS, your DevEco Studio must be V3.0.0.601 Beta1 or later.
 >
 >  For best possible results, use [DevEco Studio V3.0.0.993](https://developer.harmonyos.com/cn/develop/deveco-studio#download) for your development.
 
@@ -37,7 +37,7 @@
   - **src > main > ets > MainAbility > pages**: pages contained in **MainAbility**.
   - **src > main > ets > MainAbility > pages > index.ets**: the first page in the **pages** list, also referred to as the entry to the application.
   - **src > main > ets > MainAbility > app.ets**: ability lifecycle file.
-  - **src > main > resources**: a collection of resource files used by your application/service, such as graphics, multimedia, character strings, and layout files. For details about resource files, see [Resource File Categories](../ui/ui-ts-basic-resource-file-categories.md).
+  - **src > main > resources**: a collection of resource files used by your application/service, such as graphics, multimedia, character strings, and layout files. For details about resource files, see [Resource Categories and Access](resource-categories-and-access.md#resource-categories).
   - **src > main > config.json**: module configuration file. This file describes the global configuration information of the application/service, the device-specific configuration information, and the configuration information of the HAP file. For details about the configuration file, see [Application Package Structure Configuration File (FA Model)](package-structure.md).
   - **build-profile.json5**: current module information and build configuration options, including **buildOption** and **targets**.
   - **hvigorfile.js**: module-level compilation and build task script. You can customize related tasks and code implementation.
@@ -53,7 +53,6 @@
 
    After the project synchronization is complete, choose **entry** > **src** > **main** > **ets** > **MainAbility** > **pages** in the **Project** window and open the **index.ets** file. You can see that the file contains a **\<Text>** component. The sample code in the **index.ets** file is shown below:
    
-   
    ```ts
    // index.ets
    @Entry
@@ -79,7 +78,6 @@
 
    On the default page, add a **\<Button>** component to respond to user clicks and implement redirection to another page. The sample code in the **index.ets** file is shown below:
    
-   
    ```ts
    // index.ets
    @Entry
@@ -150,7 +148,6 @@
 
    Add **\<Text>** and **\<Button>** components and set their styles, as you do for the first page. The sample code in the **second.ets** file is shown below:
    
-   
    ```ts
    // second.ets
    @Entry
@@ -193,7 +190,6 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    In the **index.ets** file of the first page, bind the **onClick** event to the **Next** button so that clicking the button redirects the user to the second page. The sample code in the **index.ets** file is shown below:
    
-   
    ```ts
    // index.ets
    import router from '@ohos.router';
@@ -238,7 +234,6 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    In the **second.ets** file of the second page, bind the **onClick** event to the **Back** button so that clicking the button redirects the user back to the first page. The sample code in the **second.ets** file is shown below:
    
-   
    ```ts
    // second.ets
    import router from '@ohos.router';
@@ -295,4 +290,4 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    ![en-us_image_0000001363934577](figures/en-us_image_0000001363934577.png)
 
-Congratulations! You have finished developing your OpenHarmony application in eTS in the FA model. To learn more about OpenHarmony application development, see [Application Development Overview](../application-dev-guide.md).
+Congratulations! You have finished developing your OpenHarmony application in ArkTS in the FA model. To learn more about OpenHarmony application development, see [Application Development Overview](../application-dev-guide.md).

en/application-dev/quick-start/start-with-ets-stage.md

-# Getting Started with eTS in Stage Model
+# Getting Started with ArkTS in Stage Model
 
 
 > **NOTE**
 >
-> To use eTS, your DevEco Studio must be V3.0.0.900 Beta3 or later.
+> To use ArkTS, your DevEco Studio must be V3.0.0.900 Beta3 or later.
 >
 > For best possible results, use [DevEco Studio V3.0.0.993](https://developer.harmonyos.com/cn/develop/deveco-studio#download) for your development.
 
@@ -41,7 +41,7 @@
   - **src > main > ets > MainAbility**: entry to your application/service.
   - **src > main > ets > MainAbility > MainAbility.ets**: ability lifecycle file.
   - **src > main > ets > pages**: pages contained in **MainAbility**.
-  - **src > main > resources**: a collection of resource files used by your application/service, such as graphics, multimedia, character strings, and layout files. For details about resource files, see [Resource File Categories](../ui/ui-ts-basic-resource-file-categories.md).
+  - **src > main > resources**: a collection of resource files used by your application/service, such as graphics, multimedia, character strings, and layout files. For details about resource files, see [Resource Categories and Access](resource-categories-and-access.md#resource-categories).
   - **src > main > module.json5**: module configuration file. This file describes the global configuration information of the application/service, the device-specific configuration information, and the configuration information of the HAP file. For details about the configuration file, see [Application Package Structure Configuration File (Stage Model)](stage-structure.md).
   - **build-profile.json5**: current module information and build configuration options, including **buildOption** and **targets**.
   - **hvigorfile.js**: module-level compilation and build task script. You can customize related tasks and code implementation.
@@ -55,8 +55,7 @@
 
 1. Use the **\<Text>** component.
 
-   After the project synchronization is complete, choose **entry** > **src** > **main** > **ets** > **MainAbility** > **pages** in the **Project** window and open the **index.ets** file. You can see that the file contains a **\<Text>** component. The sample code in the **index.ets** file is shown below:
-
+   After the project synchronization is complete, choose **entry** > **src** > **main** > **ets** > **pages** in the **Project** window and open the **index.ets** file. You can see that the file contains a **\<Text>** component. The sample code in the **index.ets** file is shown below:
    
    ```ts
    // index.ets
@@ -83,7 +82,6 @@
 
    On the default page, add a **\<Button>** component to respond to user clicks and implement redirection to another page. The sample code in the **index.ets** file is shown below:
    
-   
    ```ts
    // index.ets
    @Entry
@@ -148,7 +146,6 @@
 
    Add **\<Text>** and **\<Button>** components and set their styles, as you do for the first page. The sample code in the **second.ets** file is shown below:
    
-   
    ```ts
    // second.ets
    @Entry
@@ -191,7 +188,6 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    In the **index.ets** file of the first page, bind the **onClick** event to the **Next** button so that clicking the button redirects the user to the second page. The sample code in the **index.ets** file is shown below:
    
-   
    ```ts
    // index.ets
    import router from '@ohos.router';
@@ -236,7 +232,6 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    In the **second.ets** file of the second page, bind the **onClick** event to the **Back** button so that clicking the button redirects the user back to the first page. The sample code in the **second.ets** file is shown below:
    
-   
    ```ts
    // second.ets
    import router from '@ohos.router';
@@ -293,4 +288,4 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    ![en-us_image_0000001311334972](figures/en-us_image_0000001311334972.png)
 
-Congratulations! You have finished developing your OpenHarmony application in eTS in the stage model. To learn more about OpenHarmony application development, see [Application Development Overview](../application-dev-guide.md).
+Congratulations! You have finished developing your OpenHarmony application in ArkTS in the stage model. To learn more about OpenHarmony application development, see [Application Development Overview](../application-dev-guide.md).

en/application-dev/quick-start/start-with-js-fa.md

@@ -52,7 +52,6 @@
 
    After the project synchronization is complete, choose **entry** > **src** > **main** > **js** > **MainAbility** > **pages** > **index** in the **Project** window and open the **index.hml** file. You can see that the file contains a **<Text>** component. The sample code in the **index.hml** file is shown below:
    
-   
    ```html
    <!-- index.hml -->
    <div class="container">
@@ -66,7 +65,6 @@
 
    On the default page, add a **\<Button>** component to respond to user clicks and implement redirection to another page. The sample code in the **index.hml** file is shown below:
    
-   
    ```html
    <!-- index.hml -->
    <div class="container">
@@ -83,7 +81,6 @@
 
    From the **Project** window, choose **entry** > **src** > **main** > **js** > **MainAbility** > **pages** > **index**, open the **index.css** file, and set the page styles, such as the width, height, font size, and spacing. The sample code in the **index.css** file is shown below:
    
-   
    ```css
    /* index.css */
    .container {
@@ -132,7 +129,6 @@
 
    Add **\<Text>** and **\<Button>** components and set their styles, as you do for the first page. The sample code in the **second.hml** file is shown below:
    
-   
    ```html
    <!-- second.hml -->
    <div class="container">
@@ -187,7 +183,6 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    In the **index.js** file of the first page, bind the **onclick** method to the button so that clicking the button redirects the user to the second page. The sample code in the **index.js** file is shown below:
    
-   
    ```js
    // index.js
    import router from '@ohos.router';
@@ -205,7 +200,6 @@ You can implement page redirection through the [page router](../reference/apis/j
 
    In the **second.ets** file of the second page, bind the **back** method to the **Back** button so that clicking the button redirects the user back to the first page. The sample code in the **second.js** file is shown below:
    
-   
    ```js
    // second.js
    import router from '@ohos.router';

en/application-dev/quick-start/syscap.md

@@ -8,6 +8,10 @@ SysCap is short for System Capability. It refers to a standalone feature in the
 
 ![image-20220326064841782](figures/image-20220326064841782.png)
 
+For details about the SysCap sets in OpenHarmony, see [SysCap List](../reference/syscap-list.md).
+
+
+
 ### Supported SysCap Set, Associated SysCap Set, and Required SysCap Set
 
 The supported SysCap set, associated SysCap set, and required SysCap set are collections of SysCaps.
@@ -60,14 +64,14 @@ You can add APIs to the associated SysCap set in DevEco Studio by adding system
 Exercise caution when modifying the required SysCap set. Incorrect modifications may result in the application being unable to be distributed to the target device.
 
 ```json
-/* syscap.json */
+// syscap.json
 {
 	"devices": {
-		"general": [            /* General devices. Each general device supports a SysCap set. Multiple general devices can be configured. */
+		"general": [            // General devices. Each general device supports a SysCap set. Multiple general devices can be configured.
 			"default",
 			"car"
 		],
-		"custom": [             /* Custom devices. */
+		"custom": [             // Custom devices.
 			{
 				"Custom device": [
 					"SystemCapability.Communication.SoftBus.Core"
@@ -75,12 +79,12 @@ Exercise caution when modifying the required SysCap set. Incorrect modifications
 			}
 		]
 	},
-	"development": {             /* The SysCap set in addedSysCaps and the SysCap set supported by each device configured in devices form the associated SysCap set. */
+	"development": {             // The SysCap set in addedSysCaps and the SysCap set supported by each device configured in devices form the associated SysCap set.
 		"addedSysCaps": [
 			"SystemCapability.Location.Location.Lite"
 		]
 	},
-	"production": {              /* Used to generate the RPCID. Exercise caution when adding this parameter. Under incorrect settings, applications may fail to be distributed to target devices. */
+	"production": {              // Used to generate the RPCID. Exercise caution when adding this parameter. Under incorrect settings, applications may fail to be distributed to target devices.
 		"addedSysCaps": [],      // Intersection of SysCap sets supported by devices configured in devices. It is the required SysCap set with addedSysCaps set and removedSysCaps set.
 		"removedSysCaps": []     // When the required SysCap set is a capability subset of a device, the application can be distributed to the device.
 	}

en/application-dev/reference/apis/js-apis-inputmethod-extension-context.md

@@ -47,8 +47,9 @@ Starts an ability with the **want** parameter. This API uses an asynchronous cal
 
   ```js
     let want = {
-      "bundleName": "com.example.myapp",
-      "abilityName": "MyAbility"};
+        'bundleName': 'com.example.myapp',
+        'abilityName': 'MyAbility'
+    };
     this.context.startAbility(want, (err) => {
         console.log('startAbility result:' + JSON.stringify(err));
     });
@@ -79,8 +80,8 @@ Starts an ability with the mandatory **want** and optional **options** parameter
 
   ```js
     let want = {
-        "bundleName": "com.example.myapp",
-        "abilityName": "MyAbility"
+        'bundleName': 'com.example.myapp',
+        'abilityName': 'MyAbility'
     };
     this.context.startAbility(want).then((data) => {
         console.log('success:' + JSON.stringify(data));
@@ -110,15 +111,15 @@ Starts an ability with the **want** and **options** parameters. This API uses an
 
   ```js
   var want = {
-  	"deviceId": "",
-  	"bundleName": "com.extreme.test",
-  	"abilityName": "MainAbility"
+  	'deviceId': '',
+  	'bundleName': 'com.extreme.test',
+  	'abilityName': 'MainAbility'
   };
   var options = {
   	windowMode: 0,
   };
   this.context.startAbility(want, options, (error) => {
-    console.log("error.code = " + error.code)
+      console.log('error.code = ' + error.code)
   })
   ```
 

en/application-dev/reference/apis/js-apis-inputmethod.md

@@ -47,7 +47,7 @@ Obtains an **[InputMethodController](#inputmethodcontroller)** instance.
 
 | Type                                           | Description                    |
 | ----------------------------------------------- | ------------------------ |
-| [InputMethodController](#inputmethodcontroller) | Returns the current **InputMethodController** instance.|
+| [InputMethodController](#inputmethodcontroller) | Current **InputMethodController** instance.|
 
 **Example**
 
@@ -67,7 +67,7 @@ Obtains an **[InputMethodSetting](#inputmethodsetting8)** instance.
 
 | Type                                     | Description                        |
 | ----------------------------------------- | ---------------------------- |
-| [InputMethodSetting](#inputmethodsetting8) | Returns the current **InputMethodSetting** instance.|
+| [InputMethodSetting](#inputmethodsetting8) | Current **InputMethodSetting** instance.|
 
 
 **Example**
@@ -94,15 +94,15 @@ Switches to another input method. This API can be used only in the stage model.
 **Example**
 
 ```js
-inputMethod.switchInputMethod({packageName:"com.example.kikakeyboard", methodId:"com.example.kikakeyboard"} ,(err,result) => {
+inputMethod.switchInputMethod({packageName:'com.example.kikakeyboard', methodId:'com.example.kikakeyboard'} ,(err,result) => {
     if (err) {
-        console.error("switchInputMethod err: " + JSON.stringify(err));
+        console.error('switchInputMethod err: ' + JSON.stringify(err));
         return;
     }
     if (result) {
-        console.info("Success to switchInputMethod.(callback)");
+        console.info('Success to switchInputMethod.(callback)');
     } else {
-        console.error("Failed to switchInputMethod.(callback)");
+        console.error('Failed to switchInputMethod.(callback)');
     }
 });
 ```
@@ -129,14 +129,14 @@ Switches to another input method. This API can be used only in the stage model.
 
 
 ```js
-inputMethod.switchInputMethod({packageName:"com.example.kikakeyboard", methodId:"com.example.kikakeyboard"}).then((result) => {
+inputMethod.switchInputMethod({packageName:'com.example.kikakeyboard', methodId:'com.example.kikakeyboard'}).then((result) => {
     if (result) {
-        console.info("Success to switchInputMethod.(promise)");
+        console.info('Success to switchInputMethod.(promise)');
     } else {
-        console.error("Failed to switchInputMethod.(promise)");
+        console.error('Failed to switchInputMethod.(promise)');
     }
 }).catch((err) => {
-    console.error("switchInputMethod promise err: " + err);
+    console.error('switchInputMethod promise err: ' + err);
 })
 ```
 ## inputMethod.getCurrentInputMethod<sup>9+</sup>
@@ -151,7 +151,7 @@ Obtains the current input method. This API synchronously returns the **Inputmeth
 
 | Type                                        | Description                    |
 | -------------------------------------------- | ------------------------ |
-| [InputmethodProperty](#inputmethodproperty8) | **InputmethodProperty** instance of the current input method. |
+| [InputmethodProperty](#inputmethodproperty8) | **InputmethodProperty** instance of the current input method.|
 
 **Example**
 
@@ -183,13 +183,13 @@ Hides the keyboard. This API uses an asynchronous callback to return the result.
 ```js
 InputMethodController.stopInput((error, result) => {
     if (error) {
-        console.error("failed to stopInput because: " + JSON.stringify(error));
+        console.error('failed to stopInput because: ' + JSON.stringify(error));
         return;
     }
     if (result) {
-        console.info("Success to stopInput.(callback)");
+        console.info('Success to stopInput.(callback)');
     } else {
-        console.error("Failed to stopInput.(callback)");
+        console.error('Failed to stopInput.(callback)');
     }
 });
 ```
@@ -214,12 +214,12 @@ Hides the keyboard. This API uses a promise to return the result. If any paramet
 ```js
 InputMethodController.stopInput().then((result) => {
     if (result) {
-        console.info("Success to stopInput.(promise)");
+        console.info('Success to stopInput.(promise)');
     } else {
-        console.error("Failed to stopInput.(promise)");
+        console.error('Failed to stopInput.(promise)');
     }
 }).catch((err) => {
-    console.error("stopInput promise err: " + err);
+    console.error('stopInput promise err: ' + err);
 })
 ```
 
@@ -241,7 +241,7 @@ Shows this soft keyboard. This API uses an asynchronous callback to return the r
 
 ```js
 InputMethodController.showSoftKeyboard((err) => {
-    if (err == undefined) {
+    if (err === undefined) {
         console.info('showSoftKeyboard success');
     } else {
         console.error('showSoftKeyboard failed because : ' + JSON.stringify(err));
@@ -292,7 +292,7 @@ Hides this soft keyboard. This API uses an asynchronous callback to return the r
 
 ```js
 InputMethodController.hideSoftKeyboard((err) => {
-    if (err == undefined) {
+    if (err === undefined) {
         console.info('hideSoftKeyboard success');
     } else {
         console.error('hideSoftKeyboard failed because : ' + JSON.stringify(err));
@@ -342,19 +342,17 @@ Obtains a list of activated or deactivated input methods. This API uses an async
 | Name  | Type                                               | Mandatory| Description                         |
 | -------- | --------------------------------------------------- | ---- | ----------------------------- |
 | enable   | boolean                                             | Yes  | Whether to return a list of activated input methods. The value **true** means to return a list of activated input methods, and **false** means to return a list of deactivated input methods.      |
-| callback | Array<[InputMethodProperty](#inputmethodproperty8)> | Yes  | Callback used to return a list of activated or deactivated input methods. |
+| callback | Array<[InputMethodProperty](#inputmethodproperty8)> | Yes  | Callback used to return a list of activated or deactivated input methods.|
 
 **Example**
 
 ```js
-imeList: Array<inputMethod.InputMethodProperty> = null
 InputMethodSetting.listInputMethod(true, (err,data) => {
     if (err) {
-        console.error("listInputMethod failed because: " + JSON.stringify(err));
+        console.error('listInputMethod failed because: ' + JSON.stringify(err));
         return;
     }
-    console.log("listInputMethod success");
-    this.imeList = data;
+    console.log('listInputMethod success');
  });
 ```
 
@@ -376,17 +374,15 @@ Obtains a list of activated or deactivated input methods. This API uses a promis
 
 | Type                                                        | Description                         |
 | ------------------------------------------------------------ | ----------------------------- |
-| Promise<Array<[InputMethodProperty](#inputmethodproperty8)>> | Promise used to return a list of activated or deactivated input methods. |
+| Promise<Array<[InputMethodProperty](#inputmethodproperty8)>> | Promise used to return a list of activated or deactivated input methods.|
 
 **Example**
 
 ```js
-imeList: Array<inputMethod.InputMethodProperty> = null
 InputMethodSetting.listInputMethod(true).then((data) => {
-    console.info("listInputMethod success");
-    this.imeList = data;
+    console.info('listInputMethod success');
 }).catch((err) => {
-    console.error("listInputMethod promise err: " + err);
+    console.error('listInputMethod promise err: ' + err);
 })
 ```
 
@@ -407,14 +403,12 @@ Obtains a list of installed input methods. This API uses an asynchronous callbac
 **Example**
 
 ```js
-imeList: Array<inputMethod.InputMethodProperty> = null
 InputMethodSetting.listInputMethod((err,data) => {
     if (err) {
-        console.error("listInputMethod failed because: " + JSON.stringify(err));
+        console.error('listInputMethod failed because: ' + JSON.stringify(err));
         return;
     }
-    console.log("listInputMethod success");
-    this.imeList = data;
+    console.log('listInputMethod success');
  });
 ```
 
@@ -435,12 +429,10 @@ Obtains a list of installed input methods. This API uses a promise to return the
 **Example**
 
 ```js
-imeList: Array<inputMethod.InputMethodProperty> = null
 InputMethodSetting.listInputMethod().then((data) => {
-    console.info("listInputMethod success");
-    this.imeList = data;
+    console.info('listInputMethod success');
 }).catch((err) => {
-    console.error("listInputMethod promise err: " + err);
+    console.error('listInputMethod promise err: ' + err);
 })
 ```
 
@@ -463,20 +455,20 @@ Displays a dialog box for selecting an input method. This API uses an asynchrono
 ```js
 InputMethodSetting.displayOptionalInputMethod((err) => {
     if (err) {
-        console.error("displayOptionalInputMethod failed because: " + JSON.stringify(err));
+        console.error('displayOptionalInputMethod failed because: ' + JSON.stringify(err));
         return;
     }
-    console.info("displayOptionalInputMethod success");
+    console.info('displayOptionalInputMethod success');
 });
 ```
 
 ### displayOptionalInputMethod
 
-displayOptionalInputMethod(): Promise&lt;void&gt;
+  displayOptionalInputMethod(): Promise&lt;void&gt;
 
-Displays a dialog box for selecting an input method. This API uses a promise to return the result. If any parameter is passed in, an exception is thrown.
+  Displays a dialog box for selecting an input method. This API uses a promise to return the result. If any parameter is passed in, an exception is thrown.
 
-**System capability**: SystemCapability.MiscServices.InputMethodFramework
+  **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
 
@@ -488,8 +480,8 @@ Displays a dialog box for selecting an input method. This API uses a promise to
 
 ```js
 InputMethodSetting.displayOptionalInputMethod().then(() => {
-    console.info("displayOptionalInputMethod success.(promise)");
+    console.info('displayOptionalInputMethod success.(promise)');
 }).catch((err) => {
-    console.error("displayOptionalInputMethod promise err: " + err);
+    console.error('displayOptionalInputMethod promise err: ' + err);
 })
 ```

en/application-dev/reference/apis/js-apis-inputmethodengine.md

@@ -46,6 +46,11 @@ Provides the constants.
 | FLAG_SINGLE_LINE | number | Yes| No| The edit box allows only single-line input.|
 | DISPLAY_MODE_PART | number | Yes| No| The edit box is displayed in half-screen mode.|
 | DISPLAY_MODE_FULL | number | Yes| No| The edit box is displayed in full screen.|
+| CURSOR_UP<sup>9+</sup> | number | Yes| No| The caret moves upward.|
+| CURSOR_DOWN<sup>9+</sup> | number | Yes| No| The caret moves downward.|
+| CURSOR_LEFT<sup>9+</sup> | number | Yes| No| The caret moves leftward.|
+| CURSOR_RIGHT<sup>9+</sup> | number | Yes| No| The caret moves rightward.|
+| WINDOW_TYPE_INPUT_METHOD_FLOAT<sup>9+</sup> | number | Yes| No| The input method is displayed in a floating window.|
 
 ## inputMethodEngine.getInputMethodEngine<a name="getInputMethodEngine"></a>
 
@@ -95,7 +100,7 @@ In the following API examples, you must first use [getInputMethodEngine](#getInp
 
 on(type: 'inputStart', callback: (kbController: KeyboardController, textInputClient: TextInputClient) => void): void
 
-Listens for the input method binding event. This API uses a callback to return the result.
+Listens for the input method binding event. This API uses a callback to return the result. This API requires two parameters, the first one being napi_string and the second one being napi_function. If either of these parameters is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -119,7 +124,7 @@ Listens for the input method binding event. This API uses a callback to return t
 
 off(type: 'inputStart', callback?: (kbController: KeyboardController, textInputClient: TextInputClient) => void): void
 
-Cancels listening for the input method binding event.
+Cancels listening for the input method binding event. An exception is thrown in the following cases: (1) No parameter is passed; (2) Only one parameter is passed in, and it is not napi_string; (2) Two parameters are passed in, and the first parameter is not napi_string or the second parameter is not napi_function. If only one parameter is passed in, all listeners of the specified type will be canceled. If two parameters are passed in, the current listener of the specified type will be canceled.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -135,14 +140,108 @@ Cancels listening for the input method binding event.
 **Example**
 
   ```js
-  InputMethodEngine.off('inputStart');
+  InputMethodEngine.off('inputStart', (kbController, textInputClient) => {
+      console.log('delete inputStart notification.');
+  });
+  ```
+
+### on('inputStop')<sup>9+</sup>
+
+on(type: 'inputStop', callback: () => void): void
+
+Listens for the input method stop event. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name  | Type  | Mandatory| Description                                                        |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
+| type     | string | Yes  | Listening type.<br>Set it to **'inputStop'**, which indicates listening for the input method stop event.|
+| callback | void   | Yes  | Callback used to return the result.                                                  |
+
+**Example**
+
+  ```js
+InputMethodEngine.getInputMethodEngine().on('inputStop', () => {
+    console.log('inputMethodEngine inputStop');
+});
+  ```
+
+### off('inputStop')<sup>9+</sup>
+
+off(type: 'inputStop', callback: () => void): void
+
+Cancels listening for the input method stop event. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name  | Type  | Mandatory| Description                                                        |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
+| type     | string | Yes  | Listening type.<br>Set it to **'inputStop'**, which indicates listening for the input method stop event.|
+| callback | void   | Yes  | Callback used to return the result.                                                  |
+
+**Example**
+
+  ```js
+InputMethodEngine.getInputMethodEngine().off('inputStop', () => {
+    console.log('inputMethodEngine delete inputStop notification.');
+});
+  ```
+
+### on('setCallingWindow')<sup>9+</sup>
+
+on(type: 'setCallingWindow', callback: (wid:number) => void): void
+
+Listens for the window invocation setting event. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name  | Type  | Mandatory| Description                                                        |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
+| type     | string | Yes  | Listening type.<br>Set it to **'setCallingWindow'**, which indicates listening for the window invocation setting event.|
+| callback | number | Yes  | Window ID of the caller.                                           |
+
+**Example**
+
+  ```js
+InputMethodEngine.getInputMethodEngine().on('setCallingWindow', (wid) => {
+    console.log('inputMethodEngine setCallingWindow');
+});
+  ```
+
+### off('setCallingWindow')<sup>9+</sup>
+
+off(type: 'setCallingWindow', callback: (wid:number) => void): void
+
+Cancels listening for the window invocation setting event. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name  | Type  | Mandatory| Description                                                        |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
+| type     | string | Yes  | Listening type.<br>Set it to **'setCallingWindow'**, which indicates listening for the window invocation setting event.|
+| callback | number | Yes  | Window ID of the caller.                                |
+
+**Example**
+
+  ```js
+InputMethodEngine.getInputMethodEngine().off('setCallingWindow', () => {
+    console.log('inputMethodEngine delete setCallingWindow notification.');
+});
   ```
 
 ### on('keyboardShow'|'keyboardHide')
 
 on(type: 'keyboardShow'|'keyboardHide', callback: () => void): void
 
-Listens for an input method event.
+Listens for an input method event. This API requires two parameters, the first one being napi_string and the second one being napi_function. If either of these parameters is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -150,14 +249,17 @@ Listens for an input method event.
 
 | Name  | Type  | Mandatory| Description                                                        |
 | -------- | ------ | ---- | ------------------------------------------------------------ |
-| type     | string | Yes  | Listening type.<br>-&nbsp;The value **'keyboardShow'** means to listen for displaying of the input method.<br>-&nbsp;The value **'keyboardHide'** means to listen for hiding of the input method.|
+| type     | string | Yes  | Listening type.<br>- The value **'keyboardShow'** means to listen for displaying of the keyboard.<br>- The value **'keyboardHide'** means to listen for hiding of the keyboard. |
 | callback | void   | No  | Callback used to return the result.                                                  |
 
 **Example**
 
   ```js
-  InputMethodEngine.on('keyboardShow', (err) => {
-      console.info('keyboardShow');
+  InputMethodEngine.on('keyboardShow', () => {
+      console.log('inputMethodEngine keyboardShow.');
+  });
+  InputMethodEngine.on('keyboardHide', () => {
+      console.log('inputMethodEngine keyboardHide.');
   });
   ```
 
@@ -165,7 +267,7 @@ Listens for an input method event.
 
 off(type: 'keyboardShow'|'keyboardHide', callback?: () => void): void
 
-Cancels listening for an input method event.
+Cancels listening for an input method event. An exception is thrown in the following cases: (1) No parameter is passed; (2) Only one parameter is passed in, and it is not napi_string; (2) Two parameters are passed in, and the first parameter is not napi_string or the second parameter is not napi_function. If only one parameter is passed in, all listeners of the specified type will be canceled. If two parameters are passed in, the current listener of the specified type will be canceled.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -173,13 +275,18 @@ Cancels listening for an input method event.
 
 | Name  | Type  | Mandatory| Description                                                        |
 | -------- | ------ | ---- | ------------------------------------------------------------ |
-| type     | string | Yes  | Listening type.<br>-&nbsp;The value **'keyboardShow'** means to listen for displaying of the input method.<br>-&nbsp;The value **'keyboardHide'** means to listen for hiding of the input method.|
+| type     | string | Yes  | Listening type.<br>- The value **'keyboardShow'** means to listen for displaying of the keyboard.<br>- The value **'keyboardHide'** means to listen for hiding of the keyboard.|
 | callback | void   | No  | Callback used to return the result.                                                  |
 
 **Example**
 
   ```js
-  InputMethodEngine.off('keyboardShow');
+  InputMethodEngine.off('keyboardShow', () => {
+      console.log('inputMethodEngine delete keyboardShow notification.');
+  });
+  InputMethodEngine.off('keyboardHide', () => {
+      console.log('inputMethodEngine delete keyboardHide notification.');
+  });
   ```
 
 
@@ -191,7 +298,7 @@ In the following API examples, you must first use [createKeyboardDelegate](#crea
 
 on(type: 'keyDown'|'keyUp', callback: (event: KeyEvent) => boolean): void
 
-Listens for a hard keyboard even. This API uses a callback to return the key information.
+Listens for a hard keyboard even. This API uses a callback to return the key information. This API requires two parameters, the first one being napi_string and the second one being napi_function. If either of these parameters is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -199,7 +306,7 @@ Listens for a hard keyboard even. This API uses a callback to return the key inf
 
 | Name  | Type                           | Mandatory| Description                                                        |
 | -------- | ------------------------------- | ---- | ------------------------------------------------------------ |
-| type   | string         | Yes  | Listening type.<br>-&nbsp;The value **'keyDown'** means to listen for pressing of a key.<br>-&nbsp;The value **'keyUp'** means to listen for releasing of a key.|
+| type   | string         | Yes  | Listening type.<br>- The value **'keyDown'** means to listen for pressing of a key.<br>- The value **'keyUp'** means to listen for releasing of a key.|
 | callback | [KeyEvent](#KeyEvent) | Yes| Callback used to return the key information.|
 
 
@@ -207,8 +314,15 @@ Listens for a hard keyboard even. This API uses a callback to return the key inf
 **Example**
 
   ```js
-  KeyboardDelegate.on('keyDown', (event) => {
-      console.info('keyDown');
+  KeyboardDelegate.on('keyUp', (keyEvent) => {
+      console.info('inputMethodEngine keyCode.(keyUp):' + JSON.stringify(keyEvent.keyCode));
+      console.info('inputMethodEngine keyAction.(keyUp):' + JSON.stringify(keyEvent.keyAction));
+      return true;
+  });
+  KeyboardDelegate.on('keyDown', (keyEvent) => {
+      console.info('inputMethodEngine keyCode.(keyDown):' + JSON.stringify(keyEvent.keyCode));
+      console.info('inputMethodEngine keyAction.(keyDown):' + JSON.stringify(keyEvent.keyAction));
+      return true;
   });
   ```
 
@@ -216,7 +330,7 @@ Listens for a hard keyboard even. This API uses a callback to return the key inf
 
 off(type: 'keyDown'|'keyUp', callback?: (event: KeyEvent) => boolean): void
 
-Cancels listening for a hard keyboard even.
+Cancels listening for a hard keyboard even. An exception is thrown in the following cases: (1) No parameter is passed; (2) Only one parameter is passed in, and it is not napi_string; (2) Two parameters are passed in, and the first parameter is not napi_string or the second parameter is not napi_function. If only one parameter is passed in, all listeners of the specified type will be canceled. If two parameters are passed in, the current listener of the specified type will be canceled.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -224,20 +338,27 @@ Cancels listening for a hard keyboard even.
 
 | Name  | Type                 | Mandatory| Description                                                        |
 | -------- | --------------------- | ---- | ------------------------------------------------------------ |
-| type     | string                | Yes  | Listening type.<br>-&nbsp;The value **'keyDown'** means to listen for pressing of a key.<br>-&nbsp;The value **'keyUp'** means to listen for releasing of a key.|
+| type     | string                | Yes  | Listening type.<br>- The value **'keyDown'** means to listen for pressing of a key.<br>- The value **'keyUp'** means to listen for releasing of a key.|
 | callback | [KeyEvent](#KeyEvent) | No  | Callback used to return the key information.                                          |
 
 **Example**
 
   ```js
-  KeyboardDelegate.off('keyDown');
+  KeyboardDelegate.off('keyUp', (keyEvent) => {
+      console.log('delete keyUp notification.');
+      return true;
+  });
+  KeyboardDelegate.off('keyDown', (keyEvent) => {
+      console.log('delete keyDown notification.');
+      return true;
+  });
   ```
 
 ### on('cursorContextChange')
 
 on(type: 'cursorContextChange', callback: (x: number, y:number, height:number) => void): void
 
-Listens for cursor context changes. This API uses a callback to return the cursor information.
+Listens for cursor context changes. This API uses a callback to return the cursor information. This API requires two parameters, the first one being napi_string and the second one being napi_function. If either of these parameters is not passed in, an exception is thrown.
 
   **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -253,18 +374,18 @@ Listens for cursor context changes. This API uses a callback to return the curso
   **Example**
 
 ```js
-
 KeyboardDelegate.on('cursorContextChange', (x, y, height) => {
-    console.info('cursorContextChange');
+    console.log('inputMethodEngine cursorContextChange x:' + x);
+    console.log('inputMethodEngine cursorContextChange y:' + y);
+    console.log('inputMethodEngine cursorContextChange height:' + height);
 });
-
 ```
 
 ### off('cursorContextChange')
 
 off(type: 'cursorContextChange', callback?: (x: number, y:number, height:number) => void): void
 
-Cancels listening for cursor context changes.
+Cancels listening for cursor context changes. An exception is thrown in the following cases: (1) No parameter is passed; (2) Only one parameter is passed in, and it is not napi_string; (2) Two parameters are passed in, and the first parameter is not napi_string or the second parameter is not napi_function. If only one parameter is passed in, all listeners of the specified type will be canceled. If two parameters are passed in, the current listener of the specified type will be canceled.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -279,15 +400,15 @@ Cancels listening for cursor context changes.
   **Example**
 
 ```js
-
-KeyboardDelegate.off('cursorContextChange');
-
+KeyboardDelegate.off('cursorContextChange', (x, y, height) => {
+    console.log('delete cursorContextChange notification.');
+});
 ```
 ### on('selectionChange')
 
 on(type: 'selectionChange', callback: (oldBegin: number, oldEnd: number, newBegin: number, newEnd: number) => void): void
 
-Listens for text selection changes. This API uses a callback to return the text selection information.
+Listens for text selection changes. This API uses a callback to return the text selection information. This API requires two parameters, the first one being napi_string and the second one being napi_function. If either of these parameters is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -301,18 +422,19 @@ Listens for text selection changes. This API uses a callback to return the text
   **Example**
 
 ```js
-
 KeyboardDelegate.on('selectionChange', (oldBegin, oldEnd, newBegin, newEnd) => {
-    console.info('selectionChange');
+    console.log('inputMethodEngine beforeEach selectionChange oldBegin:' + oldBegin);
+    console.log('inputMethodEngine beforeEach selectionChange oldEnd:' + oldEnd);
+    console.log('inputMethodEngine beforeEach selectionChange newBegin:' + newBegin);
+    console.log('inputMethodEngine beforeEach selectionChange newEnd:' + newEnd);
 });
-
 ```
 
 ### off('selectionChange')
 
 off(type: 'selectionChange', callback?: (oldBegin: number, oldEnd: number, newBegin: number, newEnd: number) => void): void
 
-Cancels listening for text selection changes.
+Cancels listening for text selection changes. An exception is thrown in the following cases: (1) No parameter is passed; (2) Only one parameter is passed in, and it is not napi_string; (2) Two parameters are passed in, and the first parameter is not napi_string or the second parameter is not napi_function. If only one parameter is passed in, all listeners of the specified type will be canceled. If two parameters are passed in, the current listener of the specified type will be canceled.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -326,9 +448,9 @@ Cancels listening for text selection changes.
   **Example**
 
 ```js
-
-KeyboardDelegate.off('selectionChange');
-
+KeyboardDelegate.off('selectionChange', (oldBegin, oldEnd, newBegin, newEnd) => {
+  console.log('delete selectionChange notification.');
+});
 ```
 
 
@@ -336,7 +458,7 @@ KeyboardDelegate.off('selectionChange');
 
 on(type: 'textChange', callback: (text: string) => void): void
 
-Listens for text changes. This API uses a callback to return the current text content.
+Listens for text changes. This API uses a callback to return the current text content. This API requires two parameters, the first one being napi_string and the second one being napi_function. If either of these parameters is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -350,18 +472,16 @@ Listens for text changes. This API uses a callback to return the current text co
   **Example**
 
 ```js
-
 KeyboardDelegate.on('textChange', (text) => {
-    console.info('textChange');
+    console.log('inputMethodEngine textChange. text:' + text);
 });
-
 ```
 
 ### off('textChange')
 
 off(type: 'textChange', callback?: (text: string) => void): void
 
-Cancels listening for text changes.
+Cancels listening for text changes. An exception is thrown in the following cases: (1) No parameter is passed; (2) Only one parameter is passed in, and it is not napi_string; (2) Two parameters are passed in, and the first parameter is not napi_string or the second parameter is not napi_function. If only one parameter is passed in, all listeners of the specified type will be canceled. If two parameters are passed in, the current listener of the specified type will be canceled.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -375,7 +495,9 @@ Cancels listening for text changes.
   **Example**
 
 ```js
-KeyboardDelegate.off('textChange');
+keyboardDelegate.off('textChange', (text) => {
+    console.log('delete textChange notification. text:' + text);
+});
 ```
 
 ## KeyboardController<a name="KeyboardController"></a>
@@ -386,7 +508,7 @@ In the following API examples, you must first use [inputStart](#inputStart) to o
 
 hideKeyboard(callback: AsyncCallback&lt;void&gt;): void
 
-Hides the keyboard. This API uses an asynchronous callback to return the result.
+Hides the keyboard. This API uses an asynchronous callback to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -400,28 +522,39 @@ Hides the keyboard. This API uses an asynchronous callback to return the result.
 
 
 ```js
- KeyboardController.hideKeyboard(()=>{
- });
+KeyboardController.hideKeyboard((err) => {
+    if (err === undefined) {
+        console.error('hideKeyboard callback result---err: ' + err.msg);
+        return;
+    }
+    console.log('hideKeyboard callback.');
+});
 ```
 
 ### hideKeyboard
 
 hideKeyboard(): Promise&lt;void&gt;
 
-Hides the keyboard. This API uses an asynchronous callback to return the result.
+Hides the keyboard. This API uses a promise to return the result. If any parameter is passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Return value**
 
 | Type            | Description                     |
-| ---------------- | -------- |
-| Promise&lt;void> | Promise used to return the result.|
+| ---------------- | ------------------------- |
+| Promise&lt;void> | Promise that returns no value.|
 
 **Example**
 
 ```js
- KeyboardController.hideKeyboard();
+async function InputMethodEngine() {
+    await KeyboardController.hideKeyboard().then(() => {
+        console.info('hideKeyboard promise.');
+    }).catch((err) => {
+        console.info('hideKeyboard promise err: ' + err.msg);
+    });
+}
 ```
 
 ## TextInputClient<a name="TextInputClient"></a>
@@ -432,7 +565,7 @@ In the following API examples, you must first use [inputStart](#inputStart) to o
 
 getForward(length:number, callback: AsyncCallback&lt;string&gt;): void
 
-Obtains the specific-length text before the cursor. This API uses an asynchronous callback to return the result.
+Obtains the specific-length text before the cursor. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -446,8 +579,13 @@ Obtains the specific-length text before the cursor. This API uses an asynchronou
 **Example**
 
   ```js
-   TextInputClient.getForward(5,(text) =>{
-     console.info("text = " + text);
+  var length = 1;
+  TextInputClient.getForward(length, (err, text) => {
+      if (err === undefined) {
+          console.error('getForward callback result---err: ' + err.msg);
+          return;
+      }
+      console.log('getForward callback result---text: ' + text);
   });
   ```
 
@@ -455,7 +593,7 @@ Obtains the specific-length text before the cursor. This API uses an asynchronou
 
 getForward(length:number): Promise&lt;string&gt;
 
-Obtains the specific-length text before the cursor. This API uses an asynchronous callback to return the result.
+Obtains the specific-length text before the cursor. This API uses a promise to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -474,15 +612,21 @@ Obtains the specific-length text before the cursor. This API uses an asynchronou
 **Example**
 
   ```js
-   var text = TextInputClient.getForward(5);
-   console.info("text = " + text);
+  async function InputMethodEngine() {
+      var length = 1;
+      await TextInputClient.getForward(length).then((text) => {
+          console.info('getForward promise result---res: ' + text);
+      }).catch((err) => {
+          console.error('getForward promise err: ' + err.msg);
+      });
+  }
   ```
 
 ### getBackward
 
 getBackward(length:number, callback: AsyncCallback&lt;string&gt;): void
 
-Obtains the specific-length text after the cursor. This API uses an asynchronous callback to return the result.
+Obtains the specific-length text after the cursor. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -496,8 +640,13 @@ Obtains the specific-length text after the cursor. This API uses an asynchronous
 **Example**
 
   ```js
-   TextInputClient.getBackward(5,(text)=>{
-     console.info("text = " + text);
+  var length = 1;
+  TextInputClient.getBackward(length, (err, text) => {
+      if (err === undefined) {
+          console.error('getBackward callback result---err: ' + err.msg);
+          return;
+      }
+      console.log('getBackward callback result---text: ' + text);
   });
   ```
 
@@ -505,7 +654,7 @@ Obtains the specific-length text after the cursor. This API uses an asynchronous
 
 getBackward(length:number): Promise&lt;string&gt;
 
-Obtains the specific-length text after the cursor. This API uses an asynchronous callback to return the result.
+Obtains the specific-length text after the cursor. This API uses a promise to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -524,15 +673,21 @@ Obtains the specific-length text after the cursor. This API uses an asynchronous
 **Example**
 
   ```js
-   var text = TextInputClient.getBackward(5);
-   console.info("text = " + text);
+  async function InputMethodEngine() {
+      var length = 1;
+      await TextInputClient.getBackward(length).then((text) => {
+          console.info('getBackward promise result---res: ' + text);
+      }).catch((err) => {
+          console.error('getBackward promise err: ' + err.msg);
+      });
+  }
   ```
 
 ### deleteForward
 
 deleteForward(length:number, callback: AsyncCallback&lt;boolean&gt;): void
 
-Deletes the fixed-length text before the cursor. This API uses an asynchronous callback to return the result.
+Deletes the fixed-length text before the cursor. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -546,15 +701,24 @@ Deletes the fixed-length text before the cursor. This API uses an asynchronous c
 **Example**
 
   ```js
-  TextInputClient.deleteForward(5,(isSuccess)=>{
-    console.info("isSuccess = " + isSuccess);
+  var length = 1;
+  TextInputClient.deleteForward(length, (err, result) => {
+      if (err === undefined) {
+          console.error('deleteForward callback result---err: ' + err.msg);
+          return;
+      }
+      if (result) {
+          console.info('Success to deleteForward.(callback) ');
+      } else {
+          console.error('Failed to deleteForward.(callback) ');
+      }
   });
   ```
 ### deleteForward
 
 deleteForward(length:number): Promise&lt;boolean&gt;
 
-Deletes the fixed-length text before the cursor. This API uses an asynchronous callback to return the result.
+Deletes the fixed-length text before the cursor. This API uses a promise to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -573,15 +737,25 @@ Deletes the fixed-length text before the cursor. This API uses an asynchronous c
 **Example**
 
 ```js
-var isSuccess = TextInputClient.deleteForward(5);
- console.info("isSuccess = " + isSuccess);
+async function InputMethodEngine() {
+    var length = 1;
+    await TextInputClient.deleteForward(length).then((result) => {
+        if (result) {
+            console.info('Success to deleteForward.(promise) ');
+        } else {
+            console.error('Failed to deleteForward.(promise) ');
+        }
+    }).catch((err) => {
+        console.error('deleteForward promise err: ' + err.msg);
+    });
+}
 ```
 
 ### deleteBackward
 
 deleteBackward(length:number, callback: AsyncCallback&lt;boolean&gt;): void
 
-Deletes the fixed-length text after the cursor. This API uses an asynchronous callback to return the result.
+Deletes the fixed-length text after the cursor. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -595,22 +769,30 @@ Deletes the fixed-length text after the cursor. This API uses an asynchronous ca
   **Example**
 
 ```js
-
- TextInputClient.deleteBackward(5, (isSuccess)=>{
- console.info("isSuccess = " + isSuccess);
+var length = 1;
+TextInputClient.deleteBackward(length, (err, result) => {
+    if (err === undefined) {
+        console.error('deleteBackward callback result---err: ' + err.msg);
+        return;
+    }
+    if (result) {
+        console.info('Success to deleteBackward.(callback) ');
+    } else {
+        console.error('Failed to deleteBackward.(callback) ');
+    }
 });
-
 ```
 
 ### deleteBackward
 
 deleteBackward(length:number): Promise&lt;boolean&gt;
 
-Deletes the fixed-length text after the cursor. This API uses an asynchronous callback to return the result.
+Deletes the fixed-length text after the cursor. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
 **Parameters**
+
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | length | number | Yes| Text length.|
@@ -624,16 +806,24 @@ Deletes the fixed-length text after the cursor. This API uses an asynchronous ca
 **Example**
 
 ```js
-
- var isSuccess = TextInputClient.deleteBackward(5);
- console.info("isSuccess = " + isSuccess);
-
+async function InputMethodEngine() {
+    var length = 1;
+    await TextInputClient.deleteBackward(length).then((result) => {
+        if (result) {
+            console.info('Success to deleteBackward.(promise) ');
+        } else {
+            console.error('Failed to deleteBackward.(promise) ');
+        }
+    }).catch((err) => {
+        console.error('deleteBackward promise err: ' + err.msg);
+    });
+}
 ```
 ### sendKeyFunction
 
 sendKeyFunction(action:number, callback: AsyncCallback&lt;boolean&gt;): void
 
-Sets the Enter key to send the text to its target. This API uses an asynchronous callback to return the result.
+Sets the Enter key to send the text to its target. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -647,18 +837,24 @@ Sets the Enter key to send the text to its target. This API uses an asynchronous
   **Example**
 
 ```js
-
- TextInputClient.sendKeyFunction(inputMethod.ENTER_KEY_TYPE_NEXT,(isSuccess)=>{
-  console.info("isSuccess = " + isSuccess);
+TextInputClient.sendKeyFunction(keyFunction, (err, result) => {
+    if (err === undefined) {
+        console.error('sendKeyFunction callback result---err: ' + err.msg);
+        return;
+    }
+    if (result) {
+        console.info('Success to sendKeyFunction.(callback) ');
+    } else {
+        console.error('Failed to sendKeyFunction.(callback) ');
+    }
 });
-
 ```
 
 ### sendKeyFunction
 
 sendKeyFunction(action:number): Promise&lt;boolean&gt;
 
-Sets the Enter key to send the text to its target. This API uses an asynchronous callback to return the result.
+Sets the Enter key to send the text to its target. This API uses a promise to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -677,15 +873,24 @@ Sets the Enter key to send the text to its target. This API uses an asynchronous
 **Example**
 
   ```js
-  var isSuccess = TextInputClient.sendKeyFunction(inputMethod.ENTER_KEY_TYPE_NEXT);
-  console.info("isSuccess = " + isSuccess);
+  async function InputMethodEngine() {
+      await client.sendKeyFunction(keyFunction).then((result) => {
+          if (result) {
+              console.info('Success to sendKeyFunction.(promise) ');
+          } else {
+              console.error('Failed to sendKeyFunction.(promise) ');
+          }
+      }).catch((err) => {
+          console.error('sendKeyFunction promise err:' + err.msg);
+      });
+  }
   ```
 
 ### insertText
 
 insertText(text:string, callback: AsyncCallback&lt;boolean&gt;): void
 
-Inserts text. This API uses an asynchronous callback to return the result.
+Inserts text. This API uses an asynchronous callback to return the result. If the required two parameters are not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -699,18 +904,24 @@ Inserts text. This API uses an asynchronous callback to return the result.
 **Example**
 
 ```js
-
-TextInputClient.insertText("test", (isSuccess)=>{
-  console.info("isSuccess = " + isSuccess);
+TextInputClient.insertText('test', (err, result) => {
+    if (err === undefined) {
+        console.error('insertText callback result---err: ' + err.msg);
+        return;
+    }
+    if (result) {
+        console.info('Success to insertText.(callback) ');
+    } else {
+        console.error('Failed to insertText.(callback) ');
+    }
 });
-
 ```
 
 ### insertText
 
 insertText(text:string): Promise&lt;boolean&gt;
 
-Inserts text. This API uses an asynchronous callback to return the result.
+Inserts text. This API uses a promise to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -729,15 +940,24 @@ Inserts text. This API uses an asynchronous callback to return the result.
 **Example**
 
   ```js
-  var isSuccess = TextInputClient.insertText("test");
-  console.info("isSuccess = " + isSuccess);
+  async function InputMethodEngine() {
+      await TextInputClient.insertText('test').then((result) => {
+          if (result) {
+              console.info('Success to insertText.(promise) ');
+          } else {
+              console.error('Failed to insertText.(promise) ');
+          }
+      }).catch((err) => {
+          console.error('insertText promise err: ' + err.msg);
+      });
+  }
   ```
 
 ### getEditorAttribute
 
 getEditorAttribute(callback: AsyncCallback&lt;EditorAttribute&gt;): void
 
-Obtains the attribute of the edit box. This API uses an asynchronous callback to return the result.
+Obtains the attribute of the edit box. This API uses an asynchronous callback to return the result. If the required parameter is not passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -750,15 +970,21 @@ Obtains the attribute of the edit box. This API uses an asynchronous callback to
 **Example**
 
   ```js
-    TextInputClient.getEditorAttribute((EditorAttribute)=>{
+  TextInputClient.getEditorAttribute((err, editorAttribute) => {
+      if (err === undefined) {
+          console.error('getEditorAttribute callback result---err: ' + err.msg);
+          return;
+      }
+      console.log('editorAttribute.inputPattern(callback): ' + JSON.stringify(editorAttribute.inputPattern));
+      console.log('editorAttribute.enterKeyType(callback): ' + JSON.stringify(editorAttribute.enterKeyType));
   });
   ```
 
 ### getEditorAttribute
 
-getEditorAttribute(): EditorAttribute
+getEditorAttribute(): Promise&lt;EditorAttribute&gt;
 
-Obtains the attribute of the edit box. This API uses an asynchronous callback to return the result.
+Obtains the attribute of the edit box. This API uses a promise to return the result. If any parameter is passed in, an exception is thrown.
 
 **System capability**: SystemCapability.MiscServices.InputMethodFramework
 
@@ -771,7 +997,72 @@ Obtains the attribute of the edit box. This API uses an asynchronous callback to
 **Example**
 
    ```js
-   var EditorAttribute = TextInputClient.getEditorAttribute();
+   async function InputMethodEngine() {
+       await TextInputClient.getEditorAttribute().then((editorAttribute) => {
+           console.info('editorAttribute.inputPattern(promise): ' + JSON.stringify(editorAttribute.inputPattern));
+           console.info('editorAttribute.enterKeyType(promise): ' + JSON.stringify(editorAttribute.enterKeyType));
+       }).catch((err) => {
+           console.error('getEditorAttribute promise err: ' + err.msg);
+       });
+   }
+   ```
+
+### moveCursor<sup>9+</sup>
+
+moveCursor(direction: number, callback: AsyncCallback&lt;void&gt;): void
+
+Moves the cursor. This API uses an asynchronous callback to return the result. If the required parameter is not passed in, an exception is thrown.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name   | Type                     | Mandatory| Description          |
+| --------- | ------------------------- | ---- | -------------- |
+| direction | number                    | Yes  | Direction in which the cursor moves.|
+| callback  | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result.    |
+
+**Example**
+
+```js
+TextInputClient.moveCursor(inputMethodEngine.CURSOR_xxx, (err) => {
+    if (err === undefined) {
+        console.error('moveCursor callback result---err: ' + err.msg);
+        return;
+    }
+});
+```
+
+### moveCursor<sup>9+</sup>
+
+moveCursor(direction: number): Promise&lt;void&gt;
+
+Moves the cursor. This API uses a promise to return the result. If the required parameter is not passed in, an exception is thrown.
+
+**System capability**: SystemCapability.MiscServices.InputMethodFramework
+
+**Parameters**
+
+| Name   | Type  | Mandatory| Description          |
+| --------- | ------ | ---- | -------------- |
+| direction | number | Yes  | Direction in which the cursor moves.|
+
+**Return value** 
+
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+
+  ```js
+async function InputMethodEngine() {
+    await TextInputClient.moveCursor(inputMethodEngine.CURSOR_xxx).then(async (err) => {
+        console.log('moveCursor success');
+    }).catch((err) => {
+        console.error('moveCursor success err: ' + err.msg);
+    });
+}
   ```
 
 ## EditorAttribute<a name="EditorAttribute"></a>