!1858 TS组件文档刷新

Merge pull request !1858 from LiAn/master

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-span.md

@@ -33,7 +33,7 @@ Span(content: string)
 
 | 名称 | 参数类型 | 默认值 | 描述 |
 | -------- | -------- | -------- | -------- |
-| decoration | {<br/>type:&nbsp;[TextDecorationType](ts-appendix-enums.md#textdecorationtype枚举说明),<br/>color?:&nbsp;Color<br/>} | {<br/>type:&nbsp;TextDecorationType.None<br/>} | 设置文本装饰线样式及其颜色。 |
+| decoration | {<br/>type:&nbsp;[TextDecorationType](ts-appendix-enums.md#textdecorationtype枚举说明),<br/>color?:&nbsp;Color<br/>} | {<br/>type:&nbsp;TextDecorationType.None<br/>color：Color.Black<br/>} | 设置文本装饰线样式及其颜色。 |
 | textCase | [TextCase](ts-appendix-enums.md#textcase枚举说明) | Normal | 设置文本大小写。 |
 
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md

@@ -29,7 +29,7 @@ LongPressGesture(options?: { fingers?: number, repeat?: boolean, duration?: numb
 | onActionEnd((event?: LongPressGestureEvent) => void) | LongPress手势识别成功，手指抬起后触发回调。 | 
 | onActionCancel(event: () => void) | LongPress手势识别成功，接收到触摸取消事件触发回调。 | 
 
-- LongPressGestureEvent对象说明<sup>8+</sup>
+- LongPressGestureEvent<sup>8+</sup>对象说明
   | 属性名称 | 属性类型 | 描述 | 
   | -------- | -------- | -------- |
   | repeat | boolean | 事件是否为重复触发事件。 | 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md

@@ -59,7 +59,7 @@ PanGestureOption(options?: { fingers?: number, direction?: PanDirection, distanc
 | onActionEnd(callback: (event?: PanGestureEvent) => void) | Pan手势识别成功，手指抬起后触发回调。 | 
 | onActionCancel(callback: () => void) | Pan手势识别成功，接收到触摸取消事件触发回调。 | 
 
-- PanGestureEvent对象说明<sup>8+</sup>
+- PanGestureEvent<sup>8+</sup>对象说明
   | 属性名称 | 属性类型 | 描述 | 
   | -------- | -------- | -------- |
   | offsetX | number | 手势事件偏移量，单位为vp。 | 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md

@@ -29,7 +29,7 @@ PinchGesture(options?: { fingers?: number, distance?: number })
 | onActionEnd((event?: PinchGestureEvent) => void) | Pinch手势识别成功，手指抬起后触发回调。 | 
 | onActionCancel(event: () => void) | Pinch手势识别成功，接收到触摸取消事件触发回调。 | 
 
-- PinchGestureEvent对象说明<sup>8+</sup>
+- PinchGestureEvent<sup>8+</sup>对象说明
   | 属性名称 | 属性类型 | 描述 | 
   | -------- | -------- | -------- |
   | scale | number | 缩放比例，用于PinchGesture手势触发场景。 | 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md

@@ -29,7 +29,7 @@ RotationGesture(options?: { fingers?: number, angle?: number })
 | onActionEnd((event?: RotationGestureEvent) => void) | Rotation手势识别成功，手指抬起后触发回调。 | 
 | onActionCancel(event: () => void) | Rotation手势识别成功，接收到触摸取消事件触发回调。 | 
 
-- RotationGestureEvent对象说明<sup>8+</sup>
+- RotationGestureEvent<sup>8+</sup>对象说明
   | 属性名称 | 属性类型 | 描述 | 
   | -------- | -------- | -------- |
   | angle | number | 旋转角度。 | 

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

@@ -38,6 +38,13 @@ Scroll(scroller?: Scroller)
   | Vertical | 仅支持竖直方向滚动。 | 
   | None | 不可滚动。 | 
 
+## 事件
+
+| 名称 | 功能描述 | 
+| -------- | -------- |
+| onScroll(xOffset: number, yOffset: number) => void | 滚动事件回调, 返回滚动时水平、竖直方向偏移量。 | 
+| onScrollEdge(side: Edge) => void | 滚动到边缘事件回调。 | 
+| onScrollEnd() => void | 滚动停止事件回调。 | 
 
 ## Scroller
 
@@ -51,7 +58,7 @@ scroller: Scroller = new Scroller()
 ```
 
 
-### scroller.scrollTo
+### scrollTo
 
 scrollTo(value: { xOffset: number | string, yOffset: number | string, animation?: { duration: number, curve: Curve } }): void
 
@@ -67,7 +74,7 @@ scrollTo(value: { xOffset: number | string, yOffset: number | string, animation?
   | animation | {<br/>duration:&nbsp;number,<br/>curve:&nbsp;[Curve](ts-animatorproperty.md)&nbsp;\|<br/>CubicBezier&nbsp;\|<br/>SpringCurve<br/>} | 否 |  | 动画配置：<br/>-&nbsp;duration:&nbsp;滚动时长设置。<br/>-&nbsp;curve:&nbsp;滚动曲线设置。 |
 
 
-### scroller.scrollEdge
+### scrollEdge
 
 scrollEdge(value: Edge): void
 
@@ -81,7 +88,7 @@ scrollEdge(value: Edge): void
   | value | Edge | 是 | - | 滚动到的边缘位置。 | 
 
 
-### scroller.scrollPage
+### scrollPage
 
 scrollPage(value: { next: boolean, direction?: Axis }): void
 
@@ -93,7 +100,7 @@ scrollPage(value: { next: boolean, direction?: Axis }): void
   | next | boolean | 是 | - | 是否向下翻页。true表示向下翻页，false表示向上翻页。 |
 
 
-### scroller.currentOffset
+### currentOffset
 
 scroller.currentOffset(): Object
 
@@ -107,7 +114,7 @@ scroller.currentOffset(): Object
   | {<br/>xOffset:&nbsp;number,<br/>yOffset:&nbsp;number<br/>} | xOffset:&nbsp;水平滑动偏移;<br/>yOffset:&nbsp;竖直滑动偏移。 | 
 
 
-### scroller.scrollToIndex
+### scrollToIndex
 
 scroller.scrollToIndex(value: number): void
 
@@ -125,15 +132,6 @@ scroller.scrollToIndex(value: number): void
   | value | number | 是 | - | 要滑动到的列表项在列表中的索引值。 | 
 
 
-## 事件
-
-| 名称 | 功能描述 | 
-| -------- | -------- |
-| onScroll(xOffset:&nbsp;number,&nbsp;yOffset:&nbsp;number)&nbsp;=&gt;&nbsp;void | 滚动事件回调,&nbsp;返回滚动时水平、竖直方向偏移量。 | 
-| onScrollEdge(side:&nbsp;Edge)&nbsp;=&gt;&nbsp;void | 滚动到边缘事件回调。 | 
-| onScrollEnd()&nbsp;=&gt;&nbsp;void | 滚动停止事件回调。 | 
-
-
 ## 示例
 
 ```

zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md

@@ -25,7 +25,7 @@ Video(value: VideoOption)
   | controller | [VideoController](#videocontroller) | 否 | - | 控制器。 |
 
 
-- PlaybackSpeed类型接口说明8+
+- PlaybackSpeed<sup>8+</sup>类型接口说明
   | 名称 | 描述 | 
   | -------- | -------- |
   | Speed_Forward_0_75_X | 0.75倍速播放。 | 
@@ -73,7 +73,7 @@ Video(value: VideoOption)
 | setCurrentTime(value:&nbsp;number) | 指定视频播放的进度位置。 |
 | setCurrentTime(value:&nbsp;number,&nbsp;seekMode:&nbsp;SeekMode | 指定视频播放的进度位置，并指定跳转模式。 |
 
-- SeekMode类型接口说明8+
+- SeekMode<sup>8+</sup>类型接口说明
   | 名称 | 描述 | 
   | -------- | -------- |
   | PreviousKeyframe | 跳转到前一个最近的关键帧。 | 

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

@@ -37,21 +37,23 @@ CustomDialogController(value:{builder: CustomDialog, cancel?: () => void, aut
   | BottomEnd<sup>8+</sup> | 右下对齐。 |
 
 
-### CustomDialogController
+## CustomDialogController
 
-创建对象
+### 导入对象
 
 ```
 dialogController : CustomDialogController = new CustomDialogController(value:{builder: CustomDialog, cancel?: () => void, autoCancel?: boolean})
 ```
 
-open()
+### open()
+open(): void
 
 
 显示自定义弹窗内容，若已显示，则不生效。
 
 
-close()
+### close
+close(): void
 
 
 关闭显示的自定义弹窗，若已关闭，则不生效。

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

@@ -14,12 +14,12 @@
 
 | 名称 | 参数类型 | 默认值 | 描述 |
 | -------- | -------- | -------- | -------- |
-| linearGradient | {<br/>angle?:&nbsp;[Angle](../../ui/ts-types.md#角度类型),<br/>direction?:&nbsp;GradientDirection,<br/>colors:&nbsp;Array&lt;[ColorStop](../../ui/ts-types.md#角度类型/ts-types.md#colorstop类型)&gt;<br/>repeating?:&nbsp;boolean<br/>} | - | 线性渐变。<br/>angle:&nbsp;线性渐变的角度。<br/>direction:&nbsp;线性渐变的方向。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
-| sweepGradient | {<br/>center:&nbsp;Point,<br/>start?:&nbsp;angle,<br/>end?:&nbsp;angle,<br/>colors:&nbsp;Array&lt;[ColorStop](../../ui/ts-types.md#colorstop类型)&gt;<br/>repeating?:&nbsp;boolean<br/>} | - | 角度渐变。<br/>center：为角度渐变的中心点。<br/>start：角度渐变的起点。<br/>end：角度渐变的终点。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
-| radialGradient | {<br/>center:&nbsp;Point,<br/>radius:&nbsp;Length,<br/>colors:&nbsp;Array&lt;[ColorStop](../../ui//ts-types.md#colorstop类型)&gt;<br/>repeating:&nbsp;boolean<br/>} | - | 径向渐变。<br/>center：径向渐变的中心点。<br/>radius：径向渐变的半径。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
+| linearGradient | {<br/>angle?:&nbsp;[Angle](../../ui/ts-types.md),<br/>direction?:&nbsp;GradientDirection,<br/>colors:&nbsp;Array&lt;[ColorStop](../../ui/ts-types.md)&gt;<br/>repeating?:&nbsp;boolean<br/>} | - | 线性渐变。<br/>angle:&nbsp;线性渐变的角度。<br/>direction:&nbsp;线性渐变的方向。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
+| sweepGradient | {<br/>center:&nbsp;Point,<br/>start?:&nbsp;angle,<br/>end?:&nbsp;angle,<br/>colors:&nbsp;Array&lt;[ColorStop](../../ui/ts-types.md)&gt;<br/>repeating?:&nbsp;boolean<br/>} | - | 角度渐变。<br/>center：为角度渐变的中心点。<br/>start：角度渐变的起点。<br/>end：角度渐变的终点。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
+| radialGradient | {<br/>center:&nbsp;Point,<br/>radius:&nbsp;Length,<br/>colors:&nbsp;Array&lt;[ColorStop](../../ui/ts-types.md)&gt;<br/>repeating:&nbsp;boolean<br/>} | - | 径向渐变。<br/>center：径向渐变的中心点。<br/>radius：径向渐变的半径。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
 
 
-- GradientDirection枚举说明
+- GradientDirection枚举说明<br>
   GradientDirection用于描述渐变方向。
 
   | 名称 | 描述 | 

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

@@ -26,7 +26,7 @@
   | secondaryButton | {<br/>value:&nbsp;string,<br/>action:&nbsp;()&nbsp;=&gt;&nbsp;void<br/>} | 否 | - | 第二个按钮。<br/>value:&nbsp;弹窗里辅助按钮的文本。<br/>action:&nbsp;点击辅助按钮的回调函数。 | 
   | onStateChange | (isVisible:&nbsp;boolean)&nbsp;=&gt;&nbsp;void | 否 | - | 弹窗状态变化事件回调，参数isVisible为弹窗当前的显示状态。 | 
 
-- CustomPopupOption类型接口说明8+
+- CustomPopupOption<sup>8+</sup>类型接口说明
   | 名称 | 类型 | 必填 | 默认值 | 描述 |
   | -------- | -------- | -------- | -------- | -------- |
   | builder | ()&nbsp;=&gt;&nbsp;any | 是 | - | 提示气泡内容的构造器。 |
@@ -37,7 +37,7 @@
   | autoCancel | boolean | 否 | true | 页面有操作时，是否自动关闭气泡 |
   | onStateChange | (isVisible:&nbsp;boolean)&nbsp;=&gt;&nbsp;void | 否 | - | 弹窗状态变化事件回调，参数为弹窗当前的显示状态。 |
 
-- Placement枚举说明<sup>8+</sup>
+- Placement<sup>8+</sup>枚举说明
   | 名称 | 描述 | 
   | -------- | -------- |
   | Left | 气泡提示位于组件左侧。 | 

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

@@ -20,7 +20,7 @@
 | responseRegion | Array&lt;Rectangle&gt;&nbsp;\|&nbsp;Rectangle | {<br/>x：0,<br/>y：0,<br/>width：'100%',<br/>height：'100%'<br/>} | 设置一个或多个触摸热区，包括位置和大小。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-百分比是相对于组件本身来度量的。<br/>>&nbsp;-x和y可以设置正负值百分比。当x设置为'100%'时表示热区往右偏移组件本身宽度大小，当x设置为'-100%'时表示热区往左偏移组件本身宽度大小。当y设置为'100%'时表示热区往下偏移组件本身高度大小，当y设置为'-100%'时表示热区往上偏移组件本身高度大小。<br/>>&nbsp;-width和height只能设置正值百分比。width：'100%'表示热区宽度设置为该组件本身的宽度。比如组件本身宽度是100vp，那么'100%'表示热区宽度也为100vp。height：'100%'表示热区高度设置为该组件本身的高度。 |
 
 
-- Rectangle对象说明
+### Rectangle对象说明
   | 名称 | 类型 | 必填 | 默认值 | 描述 | 
   | -------- | -------- | -------- | -------- | -------- |
   | x | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的X坐标。 | 

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

@@ -15,7 +15,7 @@
 | -------- | -------- | -------- |
 | onClick(callback: (event?: ClickEvent) => void) | 否 | 点击动作触发该方法调用，event参数见ClickEvent介绍。 | 
 
-- ClickEvent对象说明
+### ClickEvent对象说明
   | 属性名称 | 类型 | 描述 |
   | -------- | -------- | -------- |
   | screenX | number | 点击点相对于设备屏幕左边沿的X坐标。 |

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

@@ -3,31 +3,31 @@
 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
 > 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
 
+## 事件
 
 | 名称 | 支持冒泡 | 功能描述 |
 | -------- | -------- | -------- |
-| onDragStart(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;&nbsp;[CustomBuilder](../../ui/ts-types.md#custombuilder类型8+)) | 否 | 第一次拖拽此事件绑定的组件时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;长按150毫秒(ms)可触发拖拽事件。<br/>>&nbsp;-&nbsp;优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 |
+| onDragStart(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;&nbsp;[CustomBuilder](../../ui/ts-types.md)) | 否 | 第一次拖拽此事件绑定的组件时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;长按150毫秒(ms)可触发拖拽事件。<br/>>&nbsp;-&nbsp;优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 |
 | onDragEnter(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 拖拽进入组件范围内时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;当监听了onDrop事件时，此事件才有效。 |
 | onDragMove(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 拖拽在组件范围内移动时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;当监听了onDrop事件时，此事件才有效。 |
 | onDragLeave(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 拖拽离开组件范围内时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;当监听了onDrop事件时，此事件才有效。 |
 | onDrop(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。 |
 
-
-- DragEvent对象说明
-  | 名称 | 返回值类型 | 功能描述 | 
-  | -------- | -------- | -------- |
-  | getX() | number | 当前拖拽点x轴坐标，单位为vp。 | 
-  | getY() | number | 当前拖拽点y轴坐标，单位为vp。 | 
-
-- extraParam说明
+- extraParam说明<br>
   用于返回组件在拖拽中需要用到的额外信息。
-
   extraParam是Json对象转换的string字符串，可以通过Json.parse转换的Json对象获取如下属性。
   | 属性名称 | 属性类型 | 描述 | 
   | -------- | -------- | -------- |
   | selectedIndex | number | 当拖拽事件设在父容器的子元素时，selectedIndex表示当前被拖拽子元素是父容器第selectedIndex个子元素，selectedIndex从0开始。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;仅在ListItem组件中生效。 | 
   | insertIndex | number | 当前拖拽元素在List组件中放下时，insertIndex表示被拖拽元素插入该组件的第insertIndex个位置，insertIndex从0开始。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;仅在List组件的拖拽事件中生效。 | 
 
+### DragEvent对象说明
+- 接口
+  | 名称 | 返回值类型 | 功能描述 | 
+  | -------- | -------- | -------- |
+  | getX() | number | 当前拖拽点x轴坐标，单位为vp。 | 
+  | getY() | number | 当前拖拽点y轴坐标，单位为vp。 | 
+
 
 ## 示例
 

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

@@ -16,7 +16,7 @@
 | onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 按键动作触发该方法调用，event参数见[KeyEvent](#keyevent对象说明)介绍。 | 
 
 
-## KeyEvent对象说明
+### KeyEvent对象说明
 
 - 属性
   | 属性名称 | 类型 | 描述 |

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

@@ -16,7 +16,7 @@
 | onTouch(callback: (event?: TouchEvent) => void) | 是 | 触摸动作触发该方法调用，event参数见[TouchEvent](#touchevent对象说明)介绍。 
 
 
-## TouchEvent对象说明
+### TouchEvent对象说明
 
 - 属性
   | 属性名称 | 类型 | 描述 |

zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md

@@ -17,7 +17,7 @@
 | onMouse(callback: (event?: MouseEvent) => void) | 是 | 当前组件被鼠标按键点击时或者鼠标在组件上移动时，触发该回调，event参数包含触发事件时的时间戳、鼠标按键、动作、点击触点在整个屏幕上的坐标和点击触点相对于当前组件的坐标。 |
 
 
-- MouseEvent对象说明
+### MouseEvent对象说明
   | 属性名称 | 属性类型 | 描述 |
   | -------- | -------- | -------- |
   | timestamp | number | 触发事件时的时间戳。 |

zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md

@@ -17,6 +17,7 @@
 ## 示例
 
 ```
+@Entry
 @Component
 struct CountDownTimerComponent {
     @State countDownFrom: number = 10