!7952 更新onTouch事件描述

Merge pull request !7952 from 田雨/master

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

@@ -77,9 +77,10 @@ replace(options: RouterOptions): void
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
 **参数：**
-| 参数名     | 类型                              | 必填   | 说明        |
-| ------- | ------------------------------- | ---- | --------- |
-| options | [RouterOptions](#routeroptions) | 是    | 替换页面描述信息。 |
+
+| 参数名  | 类型                            | 必填 | 说明               |
+| ------- | ------------------------------- | ---- | ------------------ |
+| options | [RouterOptions](#routeroptions) | 是   | 替换页面描述信息。 |
 
 **示例：**
 
@@ -126,9 +127,9 @@ back(options?: RouterOptions ): void
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
 **参数：**
-| 参数名     | 类型                              | 必填   | 说明                                       |
-| ------- | ------------------------------- | ---- | ---------------------------------------- |
-| options | [RouterOptions](#routeroptions) | 否    | 返回页面描述信息，其中参数url指路由跳转时会返回到指定url的界面，如果页面栈上没有url页面，则不响应该情况。如果url未设置，则返回上一页。 |
+| 参数名  | 类型                            | 必填 | 说明                                                         |
+| ------- | ------------------------------- | ---- | ------------------------------------------------------------ |
+| options | [RouterOptions](#routeroptions) | 否   | 返回页面描述信息，其中参数url指路由跳转时会返回到指定url的界面，如果页面栈上没有url页面，则不响应该情况。如果url未设置，则返回上一页，页面栈里面的page不会回收，出栈后会被回收。 |
 
 **示例：**
 

zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md

@@ -18,7 +18,7 @@ import lottie from '@ohos/lottieETS'
 ```
 
 > **说明：**
-> 在Terminal窗口使用 `npm install @ohos/lottieETS` 命令下载Lottie。
+> 在Terminal窗口使用 `npm install @ohos/lottieETS` 命令下载Lottie，下载之前需要配置权限。
 
 
 ## lottie.loadAnimation
@@ -65,7 +65,7 @@ destroy(name: string): void
     private animatePath: string = "common/lottie/data.json"
     private animateItem: any = null
 
-    private onPageHide(): void {
+    onPageHide(): void {
       console.log('onPageHide')
       lottie.destroy()
     }

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

@@ -45,6 +45,7 @@ Swiper(value:{controller?: SwiperController})
 | disableSwipe<sup>8+</sup>   | boolean                                  | false      | 禁用组件滑动切换功能。                              |
 | curve<sup>8+</sup>          | [Curve](ts-animatorproperty.md#Curve枚举说明) \| Curves | Curve.Ease | 设置Swiper的动画曲线，默认为淡入淡出曲线，常用曲线参考[Curve枚举说明](ts-animatorproperty.md#Curve枚举说明)，也可以通过插值计算模块提供的接口创建自定义的Curves([插值曲线对象](ts-interpolation-calculation.md))。 |
 | indicatorStyle<sup>8+</sup> | {<br/>left?:&nbsp;Length,<br/>top?:&nbsp;Length,<br/>right?:&nbsp;Length,<br/>bottom?:&nbsp;Length,<br/>size?:&nbsp;Length,<br/>color?:&nbsp;Color,<br/>selectedColor?:&nbsp;Color<br/>} | -          | 设置indicator样式：<br/>-&nbsp;left:&nbsp;设置导航点距离Swiper组件左边的距离。<br/>-&nbsp;top:&nbsp;设置导航点距离Swiper组件顶部的距离。<br/>-&nbsp;right:&nbsp;设置导航点距离Swiper组件右边的距离。<br/>-&nbsp;bottom:&nbsp;设置导航点距离Swiper组件底部的距离。<br/>-&nbsp;size:&nbsp;设置导航点的直径。<br/>-&nbsp;color:&nbsp;设置导航点的颜色。<br/>-&nbsp;selectedColor:&nbsp;设置选中的导航点的颜色。 |
+| displayCount<sup>8+</sup>   | number\|string                                               | 1          | 设置元素显示个数。                                           |
 
 
 ## SwiperController

zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md

@@ -68,15 +68,20 @@ close(): void
 // xxx.ets
 @CustomDialog
 struct CustomDialogExample {
+  @Link textValue: string
+  @Link inputValue: string
   controller: CustomDialogController
   cancel: () => void
   confirm: () => void
 
   build() {
     Column() {
-      Text('Software uninstall').width('70%').fontSize(20).margin({ top: 10, bottom: 10 })
-      Image($r('app.media.icon')).width(80).height(80)
-      Text('Whether to uninstall a software?').fontSize(16).margin({ bottom: 10 })
+      Text('Change text').fontSize(20).margin({ top: 10, bottom: 10 })
+      TextInput({ placeholder: '', text: this.textValue }).height(60).width('90%')
+        .onChange((value: string) => {
+          this.textValue = value
+        })
+      Text('Whether to change a text?').fontSize(16).margin({ bottom: 10 })
       Flex({ justifyContent: FlexAlign.SpaceAround }) {
         Button('cancel')
           .onClick(() => {
@@ -85,6 +90,7 @@ struct CustomDialogExample {
           }).backgroundColor(0xffffff).fontColor(Color.Black)
         Button('confirm')
           .onClick(() => {
+            this.inputValue = this.textValue
             this.controller.close()
             this.confirm()
           }).backgroundColor(0xffffff).fontColor(Color.Red)
@@ -96,8 +102,10 @@ struct CustomDialogExample {
 @Entry
 @Component
 struct CustomDialogUser {
+  @State textValue: string = ''
+  @State inputValue: string = 'click me'
   dialogController: CustomDialogController = new CustomDialogController({
-    builder: CustomDialogExample({ cancel: this.onCancel, confirm: this.onAccept }),
+    builder: CustomDialogExample({ cancel: this.onCancel, confirm: this.onAccept, textValue: $textValue, inputValue: $inputValue }),
     cancel: this.existApp,
     autoCancel: true
   })
@@ -114,7 +122,7 @@ struct CustomDialogUser {
 
   build() {
     Column() {
-      Button('click me')
+      Button(this.inputValue)
         .onClick(() => {
           this.dialogController.open()
         }).backgroundColor(0x317aff)

zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md

@@ -22,7 +22,7 @@
 | padding | {<br/>top?:&nbsp;Length,<br/>right?:&nbsp;Length,<br/>bottom?:&nbsp;Length,<br/>left?:&nbsp;Length<br/>}&nbsp;\|&nbsp;Length | 0 | 设置内边距属性。<br/>参数为Length类型时，四个方向内边距同时生效。 |
 | margin | {<br/>top?:&nbsp;Length,<br/>right?:&nbsp;Length,<br/>bottom?:&nbsp;Length,<br/>left?:&nbsp;Length<br/>}<br/>\|&nbsp;Length | 0 | 设置外边距属性。<br/>参数为Length类型时，四个方向外边距同时生效。 |
 | constraintSize | {<br/>minWidth?:&nbsp;Length,<br/>maxWidth?:&nbsp;Length,<br/>minHeight?:&nbsp;Length,<br/>maxHeight?:&nbsp;Length<br/>} | {<br/>minWidth:&nbsp;0,<br/>maxWidth:&nbsp;Infinity,<br/>minHeight:&nbsp;0,<br/>maxHeight:&nbsp;Infinity<br/>} | 设置约束尺寸，组件布局时，进行尺寸范围限制。 |
-| layoutWeight | number | 0 | 容器尺寸确定时，元素与兄弟节点主轴布局尺寸按照权重进行分配，忽略本身尺寸设置。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;仅在Row/Column/Flex布局中生效。 |
+| layoutWeight | number | 0 | 容器尺寸确定时，元素与兄弟节点主轴布局尺寸按照权重进行分配，忽略本身尺寸设置，表示自适应占满剩余空间。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;仅在Row/Column/Flex布局中生效。 |
 
 
 ## 示例

zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md

@@ -21,13 +21,13 @@
 ## TouchEvent对象说明
 
 - 属性
-  | 属性名称                | 类型                                       | 描述           |
-  | ------------------- | ---------------------------------------- | ------------ |
-  | type                | TouchType                                | 触摸事件的类型。     |
-  | touches             | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。      |
-  | changedTouches      | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 |
-  | timestamp           | number                                   | 事件时间戳。       |
-  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 被触摸元素对象。     |
+  | 属性名称            | 类型                                                         | 描述                               |
+  | ------------------- | ------------------------------------------------------------ | ---------------------------------- |
+  | type                | TouchType                                                    | 触摸事件的类型。                   |
+  | touches             | Array&lt;[TouchObject](#touchobject对象说明)&gt;             | 全部手指信息。                     |
+  | changedTouches      | Array&lt;[TouchObject](#touchobject对象说明)&gt;             | 当前发生变化的手指信息。           |
+  | timestamp           | number                                                       | 距离开机时间的时间戳，单位为毫秒。 |
+  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 被触摸元素对象。                   |
 
 
 - 接口
@@ -48,12 +48,12 @@
 
 
 ## TouchType枚举说明
-| 名称     | 描述              |
-| ------ | --------------- |
-| Down   | 手指按下时触发。        |
-| Up     | 手指抬起时触发。        |
-| Move   | 手指按压态在屏幕上移动时触发。 |
-| Cancel | 触摸事件取消时触发。      |
+| 名称   | 描述                               |
+| ------ | ---------------------------------- |
+| Down   | 手指按下时触发。                   |
+| Up     | 手指抬起时触发。                   |
+| Move   | 手指按压态在屏幕上移动时触发。     |
+| Cancel | 触摸交互过程中应用退到后台时触发。 |
 
 
 ## 示例

zh-cn/application-dev/ui/ts-component-states-state.md

 # @State
 
-@State装饰的变量是组件内部的状态数据，当这些状态数据被修改时，将会调用所在组件的build方法进行UI刷新。
+@State装饰的变量是组件内部的状态数据，当这些状态数据被修改时，将会调用所在组件的build方法进行UI刷新，只能监听第一层数据的改变，内层数据的改变@State监听不到，无法触发build生命周期。
 
 @State状态数据具有以下特征：