diff --git a/zh-cn/application-dev/quick-start/arkts-rendering-control.md b/zh-cn/application-dev/quick-start/arkts-rendering-control.md
index f1f9ca3657e46f9d6400aa414759763d6053a6cd..b9cc90f0b09ef277437451bdcd5a7b87daf54949 100644
--- a/zh-cn/application-dev/quick-start/arkts-rendering-control.md
+++ b/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中创建的子组件内使用了状态变量时,才会触发组件刷新。
>
diff --git a/zh-cn/application-dev/reference/apis/js-apis-curve.md b/zh-cn/application-dev/reference/apis/js-apis-curve.md
index 04688626a34755ce9c12562a7180c5b4b7db8e0a..9c5d2547d6bc37050153c1322f074bcb784fc76b 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-curve.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-curve.md
@@ -58,7 +58,7 @@ stepsCurve(count: number, end: boolean):ICurve
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------- | ----| ------------------------------------------------------------ |
| count | number | 是 | 阶梯的数量,需要为正整数。 |
-| end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。
-true:在终点发生阶跃变化。
-false:在起点发生阶跃变化。 |
+| end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。
-true:在终点发生阶跃变化。
-false:在起点发生阶跃变化。 |
**返回值:**
@@ -265,7 +265,7 @@ steps(count: number, end: boolean): string
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------- | ----| ------------------------------------------------------------ |
| count | number | 是 | 阶梯的数量,需要为正整数。 |
-| end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。
-true:在终点发生阶跃变化。
-false:在起点发生阶跃变化。 |
+| end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。
-true:在终点发生阶跃变化。
-false:在起点发生阶跃变化。 |
## Curves.cubicBezier(deprecated)
diff --git a/zh-cn/application-dev/reference/apis/js-apis-router.md b/zh-cn/application-dev/reference/apis/js-apis-router.md
index caad1bfcdab4c4d9be6384fa55a650d2d68249a6..6209e93602d8e95438706e9f17512d9760335b54 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-router.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-router.md
@@ -47,25 +47,21 @@ pushUrl(options: RouterOptions): Promise<void>
**示例:**
```js
-try {
- router.pushUrl({
- url: 'pages/routerpage2',
- params: {
- data1: 'message',
- data2: {
- data3: [123, 456, 789]
- }
+router.pushUrl({
+ url: 'pages/routerpage2',
+ params: {
+ data1: 'message',
+ data2: {
+ data3: [123, 456, 789]
}
+ }
+})
+ .then(() => {
+ // success
+ })
+ .catch(err => {
+ console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
})
- .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.pushUrl9+
@@ -96,25 +92,21 @@ pushUrl(options: RouterOptions, callback: AsyncCallback<void>): void
**示例:**
```js
-try {
- router.pushUrl({
- url: 'pages/routerpage2',
- params: {
- data1: 'message',
- data2: {
- data3: [123, 456, 789]
- }
- }
- }, (err) => {
- if (err) {
- console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
- return;
+router.pushUrl({
+ url: 'pages/routerpage2',
+ params: {
+ data1: 'message',
+ data2: {
+ data3: [123, 456, 789]
}
- console.info('pushUrl success');
- });
-} catch (error) {
- console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
-};
+ }
+}, (err) => {
+ if (err) {
+ console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
+ return;
+ }
+ console.info('pushUrl success');
+});
```
## router.pushUrl9+
@@ -135,7 +127,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise<void>
| 类型 | 说明 |
| ------------------- | --------- |
-| Promise<void> | 异常返回结果 |
+| Promise<void> | 异常返回结果。 |
**错误码:**
@@ -150,25 +142,21 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise<void>
**示例:**
```js
-try {
- router.pushUrl({
- url: 'pages/routerpage2',
- params: {
- data1: 'message',
- data2: {
- data3: [123, 456, 789]
- }
+router.pushUrl({
+ url: 'pages/routerpage2',
+ params: {
+ data1: 'message',
+ data2: {
+ data3: [123, 456, 789]
}
- }, 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.RouterMode.Standard)
+ .then(() => {
+ // success
+ })
+ .catch(err => {
+ console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
+ })
```
## router.pushUrl9+
@@ -200,25 +188,21 @@ pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback<voi
**示例:**
```js
-try {
- router.pushUrl({
- url: 'pages/routerpage2',
- params: {
- data1: 'message',
- data2: {
- data3: [123, 456, 789]
- }
- }
- }, router.RouterMode.Standard, (err) => {
- if (err) {
- console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
- return;
+router.pushUrl({
+ url: 'pages/routerpage2',
+ params: {
+ data1: 'message',
+ data2: {
+ data3: [123, 456, 789]
}
- console.info('pushUrl success');
- });
-} catch (error) {
- console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
-};
+ }
+}, router.RouterMode.Standard, (err) => {
+ if (err) {
+ console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
+ return;
+ }
+ console.info('pushUrl success');
+});
```
## router.replaceUrl9+
@@ -253,22 +237,18 @@ replaceUrl(options: RouterOptions): Promise<void>
**示例:**
```js
-try {
- router.replaceUrl({
- url: 'pages/detail',
- params: {
- data1: 'message'
- }
+router.replaceUrl({
+ url: 'pages/detail',
+ params: {
+ data1: 'message'
+ }
+})
+ .then(() => {
+ // success
+ })
+ .catch(err => {
+ console.error(`replaceUrl failed, code is ${err.code}, message is ${err.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.replaceUrl9+
@@ -298,22 +278,18 @@ replaceUrl(options: RouterOptions, callback: AsyncCallback<void>): void
**示例:**
```js
-try {
- router.replaceUrl({
- url: 'pages/detail',
- params: {
- data1: 'message'
- }
- }, (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({
+ url: 'pages/detail',
+ params: {
+ data1: 'message'
+ }
+}, (err) => {
+ if (err) {
+ console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
+ return;
+ }
+ console.info('replaceUrl success');
+});
```
## router.replaceUrl9+
@@ -350,22 +326,18 @@ replaceUrl(options: RouterOptions, mode: RouterMode): Promise<void>
**示例:**
```js
-try {
- router.replaceUrl({
- url: 'pages/detail',
- params: {
- data1: 'message'
- }
- }, 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({
+ url: 'pages/detail',
+ params: {
+ data1: 'message'
+ }
+}, router.RouterMode.Standard)
+ .then(() => {
+ // success
+ })
+ .catch(err => {
+ console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
+ })
```
## router.replaceUrl9+
@@ -396,22 +368,18 @@ replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback<
**示例:**
```js
-try {
- router.replaceUrl({
- url: 'pages/detail',
- params: {
- data1: 'message'
- }
- }, 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.replaceUrl({
+ url: 'pages/detail',
+ params: {
+ data1: 'message'
+ }
+}, router.RouterMode.Standard, (err) => {
+ if (err) {
+ console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
+ return;
+ }
+ console.info('replaceUrl success');
+});
```
## router.back
@@ -590,7 +558,7 @@ router.getParams();
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------------------------ |
| url | string | 是 | 表示目标页面的url,可以用以下两种格式:
- 页面绝对路径,由配置文件中pages列表提供,例如:
- pages/index/index
- pages/detail/detail
- 特殊值,如果url的值是"/",则跳转到首页。 |
-| params | Object | 否 | 表示路由跳转时要同时传递到目标页面的数据。跳转到目标页面后,使用router.getParams()获取传递的参数,此外,在类web范式中,参数也可以在页面中直接使用,如this.keyValue(keyValue为跳转时params参数中的key值),如果目标页面中已有该字段,则其值会被传入的字段值覆盖。 |
+| params | object | 否 | 表示路由跳转时要同时传递到目标页面的数据。跳转到目标页面后,使用router.getParams()获取传递的参数,此外,在类web范式中,参数也可以在页面中直接使用,如this.keyValue(keyValue为跳转时params参数中的key值),如果目标页面中已有该字段,则其值会被传入的字段值覆盖。 |
> **说明:**
@@ -636,7 +604,7 @@ export default {
### 基于TS扩展的声明式开发范式
```ts
-// 通过router.push跳转至目标页携带params参数
+// 通过router.pushUrl跳转至目标页携带params参数
import router from '@ohos.router'
@Entry
diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/animateTo.gif b/zh-cn/application-dev/reference/arkui-ts/figures/animateTo.gif
deleted file mode 100644
index 8755e2bc014f3843f8798acae725eeb0fee11f54..0000000000000000000000000000000000000000
Binary files a/zh-cn/application-dev/reference/arkui-ts/figures/animateTo.gif and /dev/null differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent1.png b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent1.png
new file mode 100644
index 0000000000000000000000000000000000000000..b2aa53b14b112434bb736d2dc2f301bac3b46043
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent1.png differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent2.png b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent2.png
new file mode 100644
index 0000000000000000000000000000000000000000..c348c9305503698fab2f6b401450048a653e581a
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent2.png differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent3.png b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent3.png
new file mode 100644
index 0000000000000000000000000000000000000000..b53d8f308a879d4b4ce84db7adac1289c8b85cfa
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent3.png differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent4.png b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent4.png
new file mode 100644
index 0000000000000000000000000000000000000000..a93f8390861d3638a35de13f38e2ab51816b8083
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/animationComponent4.png differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-listitem.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-listitem.md
index 0f36cfe25611d736164106ad72b19df528e1d555..075e7ce36f21f5b61d5b5dc7f32b69e22af9cf9a 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-listitem.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-listitem.md
@@ -1,6 +1,6 @@
# ListItem
-用来展示列表具体item,宽度默认充满List组件,必须配合List来使用。
+用来展示列表具体item,必须配合List来使用。
> **说明:**
>
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
index e45219eff3297eb33ebc4b1e0f0485338b7266e9..bcef3272e6a2ce23274f876eba6bf4b18faac93a 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
@@ -131,7 +131,7 @@ scrollToIndex(value: number): void
> **说明:**
>
-> 仅支持list组件。
+> 仅支持Grid、list、WaterFlow组件。
**参数:**
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
index b8ec7ae00273c1ca6b671dd24dc6f67fe90b8760..f61a0286729dd0b62396baf06aa74e0269eb811f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
+++ b/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
diff --git a/zh-cn/application-dev/ui/ui-ts-building-data-model.md b/zh-cn/application-dev/ui/ui-ts-building-data-model.md
index 4d516a2b3fa81a482ebaf5337efd7c080871bd07..c2fe6aa7c739a19db3a450a17f055150cf5d28b9 100644
--- a/zh-cn/application-dev/ui/ui-ts-building-data-model.md
+++ b/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
diff --git a/zh-cn/application-dev/ui/ui-ts-layout-grid-container-new.md b/zh-cn/application-dev/ui/ui-ts-layout-grid-container-new.md
index 565bdddd400c9a2fb32714855fdce94830292ea9..e8eeba071e205b26db55880fb5f4720e8402c696 100644
--- a/zh-cn/application-dev/ui/ui-ts-layout-grid-container-new.md
+++ b/zh-cn/application-dev/ui/ui-ts-layout-grid-container-new.md
@@ -27,12 +27,12 @@
栅格系统以设备的水平宽度(屏幕密度像素值,单位vp)作为断点依据,定义设备的宽度类型,形成了一套断点规则。开发者可根据需求在不同的断点区间实现不同的页面布局效果。
栅格系统默认断点将设备宽度分为xs、sm、md、lg四类,尺寸范围如下:
-| 断点名称 | 取值范围(vp)|
-| --------| ------ |
-| xs | [0, 320) |
-| sm | [320, 520) |
-| md | [520, 840) |
-| lg | [840, +∞) |
+| 断点名称 | 取值范围(vp)|
+| --------| ------ |
+| xs | [0, 320) |
+| sm | [320, 520) |
+| md | [520, 840) |
+| lg | [840, +∞) |
在GridRow新栅格组件中,允许开发者使用breakpoints自定义修改断点的取值范围,最多支持6个断点,除了默认的四个断点外,
还可以启用xl,xxl两个断点,支持六种不同尺寸(xs, sm, md, lg, xl, xxl)设备的布局设置。
@@ -88,10 +88,10 @@ 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时,子组件在任何尺寸下排序次序一致。