fixed 087161c9 from https://gitee.com/esterzhou/docs/pulls/14277

update docs (13922) Signed-off-by: N ester.zhou <ester.zhou@huawei.com>

fixed 087161c9 from https://gitee.com/esterzhou/docs/pulls/14277
update docs (13922) Signed-off-by: N ester.zhou <ester.zhou@huawei.com>
a4de9bfb · ester.zhou · 92cd2ff1 · a4de9bfb · a4de9bfb · a4de9bfb
6 changed file
--- a/en/application-dev/reference/apis/js-apis-animator.md
+++ b/en/application-dev/reference/apis/js-apis-animator.md
-# @ohos.animator
+# @ohos.animator (Animator)

-The **animator** module provides APIs for applying animation effects, including defining animations, starting animations, and playing animations in reverse order.
+The **Animator** module provides APIs for applying animation effects, including defining animations, starting animations, and playing animations in reverse order.

 > **NOTE**
 >
@@ -72,7 +72,7 @@ For details about the error codes, see [Animator Error Codes](../errorcodes/erro

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If no page is found for pageId or fail to get object property list. |
+| 100001    | if no page is found for pageId or fail to get object property list. |


 **Example**
@@ -283,7 +283,7 @@ export default {
      easing: 'friction',
      delay: 0,
      fill: 'forwards',
-      direction: 'normal',
+      direction: "normal",
      iterations: 2,
      begin: 200.0,
      end: 400.0
@@ -296,10 +296,10 @@ export default {
      easing: 'friction',
      delay: 0,
      fill: 'forwards',
-      direction: "normal",
+      direction: 'normal',
      iterations: 2,
      begin: 0,
-      end: 400.0,
+      end: 400.0
    };
    try {
      this.animator.reset(options1);
@@ -519,7 +519,7 @@ let options = {
  direction: 'normal',
  iterations: 3,
  begin: 200.0,
-  end: 400.0,
+  end: 400.0
 };
 this.animator = animator.createAnimator(options);
 ```
--- a/en/application-dev/reference/apis/js-apis-promptAction.md
+++ b/en/application-dev/reference/apis/js-apis-promptAction.md
-# @ohos.promptAction
+# @ohos.promptAction (Prompt)

 The **PromptAction** module provides APIs for creating and showing toasts, dialog boxes, and action menus.

@@ -32,7 +32,7 @@ For details about the error codes, see [promptAction Error Codes](../errorcodes/

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
+| 100001    | if UI execution context not found. |

 **Example**

@@ -88,7 +88,7 @@ For details about the error codes, see [promptAction Error Codes](../errorcodes/

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
+| 100001    | if UI execution context not found. |

 **Example**

@@ -142,7 +142,7 @@ For details about the error codes, see [promptAction Error Codes](../errorcodes/

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
+| 100001    | if UI execution context not found. |

 **Example**

@@ -218,7 +218,7 @@ For details about the error codes, see [promptAction Error Codes](../errorcodes/

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
+| 100001    | if UI execution context not found. |

 **Example**

@@ -276,7 +276,7 @@ For details about the error codes, see [promptAction Error Codes](../errorcodes/

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
+| 100001    | if UI execution context not found. |

 **Example**


--- a/en/application-dev/reference/apis/js-apis-router.md
+++ b/en/application-dev/reference/apis/js-apis-router.md
-# @ohos.router
+# @ohos.router (Page Routing)

 The **Router** module provides APIs to access pages through URLs. You can use the APIs to navigate to a specified page in an application, replace the current page with another one in an application, and return to the previous page or a specified page.

@@ -40,15 +40,14 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
-| 100002    | If the uri is not exist. |
-| 100003    | If the pages are pushed too much. |
+| 100001    | if UI execution context not found. |
+| 100002    | if the uri is not exist. |
+| 100003    | if the pages are pushed too much. |

 **Example**

 ```js
-try {
-  router.pushUrl({
+router.pushUrl({
  url: 'pages/routerpage2',
  params: {
    data1: 'message',
@@ -56,16 +55,13 @@ try {
      data3: [123, 456, 789]
    }
  }
-  })
+})
  .then(() => {
    // success
  })
  .catch(err => {
    console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
  })
-} catch (error) {
-  console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
-};
 ```

 ## router.pushUrl<sup>9+</sup>
@@ -89,15 +85,14 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
-| 100002    | If the uri is not exist. |
-| 100003    | If the pages are pushed too much. |
+| 100001    | if UI execution context not found. |
+| 100002    | if the uri is not exist. |
+| 100003    | if the pages are pushed too much. |

 **Example**

 ```js
-try {
-  router.pushUrl({
+router.pushUrl({
  url: 'pages/routerpage2',
  params: {
    data1: 'message',
@@ -105,16 +100,13 @@ try {
      data3: [123, 456, 789]
    }
  }
-  }, (err) => {
+}, (err) => {
  if (err) {
    console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushUrl success');
-  });
-} catch (error) {
-  console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
-};
+});
 ```
 ## router.pushUrl<sup>9+</sup>

@@ -143,15 +135,14 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
-| 100002    | If the uri is not exist. |
-| 100003    | If the pages are pushed too much. |
+| 100001    | if UI execution context not found. |
+| 100002    | if the uri is not exist. |
+| 100003    | if the pages are pushed too much. |

 **Example**

 ```js
-try {
-  router.pushUrl({
+router.pushUrl({
  url: 'pages/routerpage2',
  params: {
    data1: 'message',
@@ -159,16 +150,13 @@ try {
      data3: [123, 456, 789]
    }
  }
-  }, router.RouterMode.Standard)
+}, router.RouterMode.Standard)
  .then(() => {
    // success
  })
  .catch(err => {
    console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
  })
-} catch (error) {
-  console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
-};
 ```

 ## router.pushUrl<sup>9+</sup>
@@ -193,15 +181,14 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
-| 100002    | If the uri is not exist. |
-| 100003    | If the pages are pushed too much. |
+| 100001    | if UI execution context not found. |
+| 100002    | if the uri is not exist. |
+| 100003    | if the pages are pushed too much. |

 **Example**

 ```js
-try {
-  router.pushUrl({
+router.pushUrl({
  url: 'pages/routerpage2',
  params: {
    data1: 'message',
@@ -209,16 +196,13 @@ try {
      data3: [123, 456, 789]
    }
  }
-  }, router.RouterMode.Standard, (err) => {
+}, router.RouterMode.Standard, (err) => {
  if (err) {
    console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushUrl success');
-  });
-} catch (error) {
-  console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
-};
+});
 ```

 ## router.replaceUrl<sup>9+</sup>
@@ -247,28 +231,24 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found, only throw in standard system. |
-| 200002    | If the uri is not exist. |
+| 100001    | if UI execution context not found, only throw in standard system. |
+| 200002    | if the uri is not exist. |

 **Example**

 ```js
-try {
-  router.replaceUrl({
+router.replaceUrl({
  url: 'pages/detail',
  params: {
    data1: 'message'
  }
-  })
+})
  .then(() => {
    // success
  })
  .catch(err => {
    console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
  })
-} catch (error) {
-  console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
-};
 ```

 ## router.replaceUrl<sup>9+</sup>
@@ -292,28 +272,24 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found, only throw in standard system. |
-| 200002    | If the uri is not exist. |
+| 100001    | if UI execution context not found, only throw in standard system. |
+| 200002    | if the uri is not exist. |

 **Example**

 ```js
-try {
-  router.replaceUrl({
+router.replaceUrl({
  url: 'pages/detail',
  params: {
    data1: 'message'
  }
-  }, (err) => {
+}, (err) => {
  if (err) {
    console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('replaceUrl success');
-  });
-} catch (error) {
-  console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
-};
+});
 ```

 ## router.replaceUrl<sup>9+</sup>
@@ -344,28 +320,24 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found, only throw in standard system. |
-| 200002    | If the uri is not exist. |
+| 100001    | if UI execution context not found, only throw in standard system. |
+| 200002    | if the uri is not exist. |

 **Example**

 ```js
-try {
-  router.replaceUrl({
+router.replaceUrl({
  url: 'pages/detail',
  params: {
    data1: 'message'
  }
-  }, router.RouterMode.Standard)
+}, router.RouterMode.Standard)
  .then(() => {
    // success
  })
  .catch(err => {
    console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
  })
-} catch (error) {
-  console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
-};
 ```

 ## router.replaceUrl<sup>9+</sup>
@@ -390,28 +362,24 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found, only throw in standard system. |
-| 200002    | If the uri is not exist. |
+| 100001    | if UI execution context not found, only throw in standard system. |
+| 200002    | if the uri is not exist. |

 **Example**

 ```js
-try {
-  router.replaceUrl({
+router.replaceUrl({
  url: 'pages/detail',
  params: {
    data1: 'message'
  }
-  }, router.RouterMode.Standard, (err) => {
+}, router.RouterMode.Standard, (err) => {
  if (err) {
    console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('replaceUrl success');
-  });
-} catch (error) {
-  console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
-};
+});
 ```

 ## router.back
@@ -524,7 +492,7 @@ For details about the error codes, see [Router Error Codes](../errorcodes/errorc

 | ID  | Error Message|
 | --------- | ------- |
-| 100001    | If UI execution context not found. |
+| 100001    | if UI execution context not found. |

 **Example**

@@ -572,8 +540,8 @@ Obtains the parameters passed from the page that initiates redirection to the cu
 **Return value**

 | Type  | Description                              |
-| ------ | ----------------- |
-| Object | Parameters passed from the page that initiates redirection to the current page.|
+| ------ | ---------------------------------- |
+| object | Parameters passed from the page that initiates redirection to the current page.|

 **Example**

@@ -594,6 +562,7 @@ Describes the page routing options.


  > **NOTE**
+  >
  > The page routing stack supports a maximum of 32 pages.

 ## RouterMode<sup>9+</sup>
@@ -636,7 +605,7 @@ export default {
 ### TypeScript-based Declarative Development Paradigm

 ```ts
-// Navigate to the target page through router.push with the params parameter carried.
+// Navigate to the target page through router.pushUrl with the params parameter carried.
 import router from '@ohos.router'

 @Entry
@@ -745,37 +714,6 @@ router.push({
  }
 });
 ```
-## router.push<sup>(deprecated)</sup>
-
-push(options: RouterOptions, mode: RouterMode): void
-
-Navigates to a specified page in the application.
-
-This API is deprecated since API version 9. You are advised to use [pushUrl<sup>9+</sup>](#routerpushurl9) instead.
-
-**System capability**: SystemCapability.ArkUI.ArkUI.Full
-
-**Parameters**
-
-| Name    | Type                             | Mandatory  | Description        |
-| ------- | ------------------------------- | ---- | ---------- |
-| options | [RouterOptions](#routeroptions) | Yes   | Page routing parameters. |
-| mode    | [RouterMode](#routermode9)      | Yes   | Routing mode.|
-
-
-**Example**
-
-```js
-router.push({
-  url: 'pages/routerpage2/routerpage2',
-  params: {
-    data1: 'message',
-    data2: {
-      data3: [123, 456, 789]
-    }
-  }
-},router.RouterMode.Standard);
-```

 ## router.replace<sup>(deprecated)</sup>

@@ -785,7 +723,7 @@ Replaces the current page with another one in the application and destroys the c

 This API is deprecated since API version 9. You are advised to use [replaceUrl<sup>9+</sup>](#routerreplaceurl9) instead.

-**System capability**: SystemCapability.ArkUI.ArkUI.Full
+**System capability**: SystemCapability.ArkUI.ArkUI.Lite

 **Parameters**

@@ -804,34 +742,6 @@ router.replace({
 });
 ```

-## router.replace<sup>(deprecated)</sup>
-
-replace(options: RouterOptions, mode: RouterMode): void
-
-Replaces the current page with another one in the application and destroys the current page.
-
-This API is deprecated since API version 9. You are advised to use [replaceUrl<sup>9+</sup>](#routerreplaceurl9) instead.
-
-**System capability**: SystemCapability.ArkUI.ArkUI.Lite
-
-**Parameters**
-
-| Name    | Type                             | Mandatory  | Description        |
-| ------- | ------------------------------- | ---- | ---------- |
-| options | [RouterOptions](#routeroptions) | Yes   | Description of the new page. |
-| mode    | [RouterMode](#routermode9)      | Yes   | Routing mode.|
-
-**Example**
-
-```js
-router.replace({
-  url: 'pages/detail/detail',
-  params: {
-    data1: 'message'
-  }
-}, router.RouterMode.Standard);
-```
-
 ## router.enableAlertBeforeBackPage<sup>(deprecated)</sup>

 enableAlertBeforeBackPage(options: EnableAlertOptions): void

--- a/en/application-dev/reference/apis/js-apis-system-mediaquery.md
+++ b/en/application-dev/reference/apis/js-apis-system-mediaquery.md
-# Media Query
+# @system.mediaquery (Media Query)

 The **mediaquery** module provides different styles for different media types.

@@ -12,7 +12,7 @@ The **mediaquery** module provides different styles for different media types.
 ## Modules to Import


-```
+```ts
 import mediaquery from '@system.mediaquery';
 ```

@@ -39,8 +39,8 @@ Creates a **MediaQueryList** object based on the query condition.

 **Example**

-```
-var mMediaQueryList = mediaquery.matchMedia('(max-width: 466)');    
+```ts
+let mMediaQueryList = mediaquery.matchMedia('(max-width: 466)');    
 ```

 ## MediaQueryEvent
@@ -97,7 +97,7 @@ Adds a listener for this **MediaQueryList** object. The listener must be added b

 **Example**

-```
+```ts
 function maxWidthMatch(e){
  if(e.matches){
    // do something
@@ -123,7 +123,7 @@ Removes the listener for this **MediaQueryList** object.

 **Example**

-```
+```ts
 function maxWidthMatch(e){
  if(e.matches){
    // do something

--- a/en/application-dev/reference/apis/js-apis-system-prompt.md
+++ b/en/application-dev/reference/apis/js-apis-system-prompt.md
-# Prompt
+# @system.prompt (Prompt)
+
+The **PromptAction** module provides APIs for creating and showing toasts, dialog boxes, and action menus.

 > **NOTE**
 >
@@ -73,7 +75,7 @@ export default {
         },            
       ],            
       success: function(data) {                
-         console.log('dialog success callback, click button : ' + data.index);           
+         console.log('dialog success callback£¬click button : ' + data.index);            
       },            
       cancel: function() {                
         console.log('dialog cancel callback');            

--- a/en/application-dev/reference/apis/js-apis-system-router.md
+++ b/en/application-dev/reference/apis/js-apis-system-router.md
-# @system.router
+# @system.router (Page Routing)

 The **Router** module provides APIs to access pages through URIs.

@@ -127,7 +127,7 @@ Returns to the previous page or a specified page.

 | Name    | Type                                     | Mandatory  | Description                     |
 | ------- | --------------------------------------- | ---- | ----------------------- |
-| options | [BackRouterOptions](#backrouteroptions) | Yes   | For details, see **BackRouterOptions**.|
+| options | [BackRouterOptions](#backrouteroptions) | No   | For details, see **BackRouterOptions**.|

 **Example**

@@ -188,7 +188,7 @@ export default {
 >
 > In the example, the **uri** field indicates the page route, which is specified by the **pages** list in the **config.json** file.

-## router.getParams
+## router.getParams<sup>7+</sup>

 getParams(): ParamsInterface

@@ -397,6 +397,6 @@ Defines the **DisableAlertBeforeBackPage** parameters.

 ## ParamsInterface

-| Name           | Type  | Description     |
-| ------------- | ------ | ------- |
-| [key: string] | Object | List of routing parameters.|
+| Name         | Type| Description          |
+| ------------- | -------- | -------------- |
+| [key: string] | object   | List of routing parameters.|