!13379 文档整改

Merge pull request !13379 from 田雨/master

zh-cn/application-dev/quick-start/arkts-rendering-control.md

@@ -267,7 +267,7 @@ struct MyComponent {
 >
 > - 生成的子组件必须是允许包含在LazyForEach父容器组件中的子组件。
 >
-> - 允许LazyForEach包含在if/else条件渲染语句中，但不允许LazyForEach中出现if/else条件渲染语句。
+> - 允许LazyForEach包含在if/else条件渲染语句中。
 >
 > - 为了高性能渲染，通过DataChangeListener对象的onDataChange方法来更新UI时，仅当itemGenerator中创建的子组件内使用了状态变量时，才会触发组件刷新。
 >

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

@@ -58,7 +58,7 @@ stepsCurve(count: number, end: boolean)：ICurve
 | 参数名 | 类型    | 必填 | 说明                                                         |
 | ------ | ------- | ----| ------------------------------------------------------------ |
 | count  | number  | 是   | 阶梯的数量，需要为正整数。                                   |
-| end    | boolean | 是   | 在每个间隔的起点或是终点发生阶跃变化。<br>-true：在终点发生阶跃变化。<br>-false:在起点发生阶跃变化。 |
+| end    | boolean | 是   | 在每个间隔的起点或是终点发生阶跃变化。<br>-true：在终点发生阶跃变化。<br>-false：在起点发生阶跃变化。 |
 
 **返回值：**
 

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

@@ -47,8 +47,7 @@ pushUrl(options: RouterOptions): Promise<void>
 **示例：**
 
 ```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>
@@ -96,8 +92,7 @@ pushUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void
 **示例：**
 
 ```js
-try {
-  router.pushUrl({
+router.pushUrl({
   url: 'pages/routerpage2',
   params: {
     data1: 'message',
@@ -105,16 +100,13 @@ try {
       data3: [123, 456, 789]
     }
   }
-  }, (err) => {
-    if (err) {
+})
+  .then(() => {
+    // success
+  })
+  .catch(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>
 
@@ -135,7 +127,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
 
 | 类型                | 说明        |
 | ------------------- | --------- |
-| Promise&lt;void&gt; | 异常返回结果 |
+| Promise&lt;void&gt; | 异常返回结果。 |
 
 **错误码：**
 
@@ -150,8 +142,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
 **示例：**
 
 ```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>
@@ -200,8 +188,7 @@ pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;voi
 **示例：**
 
 ```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>
@@ -253,22 +237,18 @@ replaceUrl(options: RouterOptions): Promise&lt;void&gt;
 **示例：**
 
 ```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>
@@ -298,22 +278,18 @@ replaceUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void
 **示例：**
 
 ```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>
@@ -350,22 +326,18 @@ replaceUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
 **示例：**
 
 ```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>
@@ -396,22 +368,19 @@ replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;
 **示例：**
 
 ```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
@@ -572,8 +541,8 @@ getParams(): Object
 **返回值：**
 
 | 类型   | 说明                               |
-| ------ | ----------------- |
-| Object | 发起跳转的页面往当前页传入的参数。 |
+| ------ | ---------------------------------- |
+| object | 发起跳转的页面往当前页传入的参数。 |
 
 **示例：**
 
@@ -636,7 +605,7 @@ export default {
 ### 基于TS扩展的声明式开发范式
 
 ```ts
-// 通过router.push跳转至目标页携带params参数
+// 通过router.pushUrl跳转至目标页携带params参数
 import router from '@ohos.router'
 
 @Entry

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

@@ -396,5 +396,5 @@ export default {
 ## ParamsInterface
 
 | 名称          | 参数类型 | 说明           |
-| ------------- | ------ | ------- |
-| [key: string] | Object | 路由参数列表。 |
+| ------------- | -------- | -------------- |
+| [key: string] | object   | 路由参数列表。 |

zh-cn/application-dev/reference/arkui-ts/ts-container-listitem.md

 # ListItem
 
-用来展示列表具体item，宽度默认充满List组件，必须配合List来使用。
+用来展示列表具体item，必须配合List来使用。
 
 >  **说明：**
 >

zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md

@@ -131,7 +131,7 @@ scrollToIndex(value: number): void
 
 >  **说明：**
 >
->  仅支持list组件。
+>  仅支持Grid、list、WaterFlow组件。
 
 **参数：**
 

zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md

@@ -60,4 +60,20 @@ struct TransitionExample {
 }
 ```
 
-![animateTo](figures/animateTo.gif)
\ No newline at end of file
+示意图：
+
+图片完全显示时：
+
+![animationComponent1](figures/animationComponent1.png)
+
+图片消失时配置顺时针旋转180°的过渡效果：
+
+![animationComponent3](figures/animationComponent3.png)
+
+图片完全消失时：
+
+![animationComponent2](figures/animationComponent2.png)
+
+图片显示时配置横向放大一倍的过渡效果：
+
+![animationComponent4](figures/animationComponent4.png)
\ No newline at end of file

zh-cn/application-dev/ui/ui-ts-building-data-model.md

@@ -59,7 +59,7 @@
      ]
    ```
 
-   实际开发中，开发者可以自定义更多的数据资源，当食物资源很多时，建议使用数据懒加载LazyForEach。
+   实际开发中，开发者可以自定义更多的数据资源，当食物资源很多时，建议使用[数据懒加载LazyForEach](../quick-start/arkts-rendering-control.md#数据懒加载)。
 
 5. 创建initializeOnStartUp方法来初始化FoodData的数组。在FoodDataModels.ets中使用了定义在FoodData.ets的FoodData和Category，所以要将FoodData.ets的FoodData类export，在FoodDataModels.ets内import FoodData和Category。
    ```ts

zh-cn/application-dev/ui/ui-ts-layout-grid-container-new.md

@@ -88,7 +88,7 @@ GridRow({
        }.backgroundColor(color)
      })
 }                                                                    
-```
+  ```
 
 ![](figures/breakpoints.gif)
 
@@ -333,8 +333,8 @@ GridCol组件作为GridRow组件的子组件，通过给GridCol传参或者设
 
 ### order
 
-  栅格子组件的序号，决定子组件排列次序。当子组件不设置order或者设置相同的order, 子组件按照代码顺序展示。当子组件设置不同的order时，order较大的组件在前，较小的在后。
-  当子组件部分设置order，部分不设置order时，未设置order的子组件依次排序靠前，设置了order的子组件按照数值从大到小排列。
+  栅格子组件的序号，决定子组件排列次序。当子组件不设置order或者设置相同的order, 子组件按照代码顺序展示。当子组件设置不同的order时，order较小的组件在前，较大的在后。
+  当子组件部分设置order，部分不设置order时，未设置order的子组件依次排序靠前，设置了order的子组件按照数值从小到大排列。
 
 
 - 当类型为number时，子组件在任何尺寸下排序次序一致。