3.1文档修改

Signed-off-by: Nkangchongtao <kangchongtao@huawei.com>

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

@@ -43,7 +43,7 @@ AlphabetIndexer(value: {arrayValue: Array<string>, selected: number})
 | itemSize                | string \| number                    | 设置字母索引条字母区域大小，字母区域为正方形，即正方形边长。       |
 | alignStyle              | IndexerAlign                             | 设置字母索引条弹框的对齐样式，支持弹窗显示在索引条右侧和左侧。<br/>默认值：IndexerAlign.Right |
 | selected | number | 设置选中项索引值。 |
-| popupPosition | {<br/>x?:[Length](ts-types.md#length)<br/>y?:[Length](ts-types.md#length)<br/>} | 设置弹出窗口相对于索引器条上边框中点的位置。 |
+| popupPosition | [Position](ts-types.md#position8) | 设置弹出窗口相对于索引器条上边框中点的位置。 |
 
 ## IndexerAlign枚举说明
 

zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-circle.md

@@ -21,7 +21,7 @@
 
 Circle(options?: {width?: string | number, height?: string | number})
 
-- 参数
+## 参数
   | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
   | -------- | -------- | -------- | -------- | -------- |
   | width | string \| number | 否 | 0 | 宽度。 |

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

@@ -12,22 +12,15 @@
 
 ## AnimationOptions对象说明
 
-### 属性
-
-| 属性名称       | 属性类型                      | 默认值    | 描述                                  |
-| ---------- | ------------------------- | ------ | ----------------------------------- |
-| duration   | number                    | 1000   | 动画持续时间，单位为毫秒。                       |
-| tempo      | number                    | 1.0    | 动画的播放速度，值越大动画播放越快，值越小播放越慢，为0时无动画效果。 |
-| curve      | Curve \| Curves | Linear | 动画曲线。                               |
-| delay      | number                    | 0      | 单位为ms(毫秒)，默认不延时播放。                  |
-| iterations | number                    | 1      | 默认播放一次，设置为-1时表示无限次播放。               |
-| playMode   | [PlayMode](ts-appendix-enums.md#playmode)      | Normal | 设置动画播放模式，默认播放完成后重头开始播放。             |
-
-### 接口
-
-| 名称                              | 功能描述      |
-| ------------------------------- | --------- |
-| onFinish() => void | 动效播放完成回调。 |
+| 名称       | 类型                | 必填 | 默认值    | 描述                                  |
+| ---------- | ------------------------- | ----- | ------ | ----------------------------------- |
+| duration   | number                    |  否   | 1000   | 动画持续时间，单位为毫秒。                       |
+| tempo      | number                    |  否   | 1.0    | 动画的播放速度，值越大动画播放越快，值越小播放越慢，为0时无动画效果。 |
+| curve      | Curve \| Curves |  否   | Curve.Linear | 动画曲线。                               |
+| delay      | number                    |  否   | 0      | 单位为ms(毫秒)，默认不延时播放。                  |
+| iterations | number                    |  否   | 1      | 默认播放一次，设置为-1时表示无限次播放。               |
+| playMode   | [PlayMode](ts-appendix-enums.md#playmode)| 否   | PlayMode.Normal | 设置动画播放模式，默认播放完成后重头开始播放。             |
+| onFinish   | () => void   |  否   |   -    | 动效播放完成回调。 |
 
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-methods-action-sheet.md

@@ -14,29 +14,29 @@
 
 ## ActionSheet.show
 
-show(value?: {&nbsp; title?: string&nbsp;|&nbsp;Resource,message?:  string&nbsp;|&nbsp;Resource,confirm?:{value: string&nbsp;|&nbsp;Resource,action:() => void},cancel?:()=>void,sheets?:Array<SheetInfo&gt;,autoCancel?:boolean, alignment?: DialogAlignment , offset?: { dx: number | string | Resource; dy: number | string | Resource } })
+show(value: {&nbsp;title: string&nbsp;|&nbsp;Resource,&nbsp;message: string&nbsp;|&nbsp;Resource,&nbsp;confirm?: {value: string&nbsp;|&nbsp;Resource,&nbsp;action:() => void},&nbsp;cancel?:()=>void,&nbsp;sheets: Array&lt;SheetInfo&gt;,&nbsp;autoCancel?:boolean,&nbsp;alignment?: DialogAlignment,&nbsp;offset?: { dx: number | string | Resource; dy: number | string | Resource } })
 
 定义列表弹窗并弹出。
 
-- paramObject1参数
+**参数：**
   | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
   | -------- | -------- | -------- | -------- | -------- |
-  | title | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 否 | 无标题 | 弹窗标题。 |
+  | title | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 是 | - | 弹窗标题。 |
   | message | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 是 | - | 弹窗内容。 |
   | autoCancel | boolean | 否 | true | 点击遮障层时，是否关闭弹窗。 |
   | confirm | {<br/>value:&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>action:&nbsp;()&nbsp;=&gt;&nbsp;void<br/>} | 否 | - | 确认按钮的文本内容和点击回调。<br/>value：按钮文本内容。<br/>action:&nbsp;按钮选中时的回调。 |
   | cancel | ()&nbsp;=&gt;&nbsp;void | 否 | - | 点击遮障层关闭dialog时的回调。 |
   | alignment | [DialogAlignment](ts-methods-custom-dialog-box.md) | 否 | DialogAlignment.Default | 弹窗在竖直方向上的对齐方式。 |
   | offset | {<br/>dx:&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>dy:&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource)<br/>} | 否 | {<br/>dx:&nbsp;0,<br/>dy:&nbsp;0<br/>} | 弹窗相对alignment所在位置的偏移量。 |
-  | sheets | Array<SheetInfo&gt; | 是 | - | 设置选项内容，每个选择项支持设置图片、文本和选中的回调。 |
+  | sheets | Array&lt;SheetInfo&gt; | 是 | - | 设置选项内容，每个选择项支持设置图片、文本和选中的回调。 |
 
-- SheetInfo接口说明
+## SheetInfo接口说明
   
-  | 参数名 | 参数类型                                             | 必填 | 默认值 | 参数描述          |
-  | ------ | ---------------------------------------------------- | ---- | ------ | ----------------- |
-  | title  | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 是   | -      | sheet文本。       |
-  | icon   | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 否   | 无     | sheet图标。       |
-  | action | ()=&gt;void                                          | 是   | -      | sheet选中的回调。 |
+  | 参数名 | 参数类型                                                     | 必填 | 参数描述          |
+  | ------ | ------------------------------------------------------------ | ---- | ----------------- |
+  | title  | string&nbsp;\|&nbsp;[Resource](../../ui/ts-types.md#resource) | 是   | 选项的文本内容。       |
+  | icon   | string&nbsp;\|&nbsp;[Resource](../../ui/ts-types.md#resource) | 否   | 选项的图标，默认无图标显示。     |
+  | action | ()=&gt;void                                                  | 是   | 选项选中的回调。 |
 
 
 ## 示例

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

@@ -11,9 +11,9 @@
 
 | 名称 | 参数类型 | 默认值 | 参数描述 |
 | -------- | -------- | -------- | -------- |
-| show | options: { paramObject1 \| paramObject2} | - | 定义并显示AlertDialog组件。 |
+| show | value: { AlertDialogParamWithConfirm \| AlertDialogParamWithButtons} | - | 定义并显示AlertDialog组件。 |
 
-- paramObject1参数
+## AlertDialogParamWithConfirm对象说明
   | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
   | -------- | -------- | -------- | -------- | -------- |
   | title | string \| [Resource](ts-types.md#resource) | 否 | - | 弹窗标题。 |
@@ -21,12 +21,12 @@
   | autoCancel | boolean | 否 | true | 点击遮障层时，是否关闭弹窗。 |
   | confirm | {<br/>value:&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>fontColor?:&nbsp;Color&nbsp;\|&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>backgroundColor?:&nbsp;Color&nbsp;\|&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>action:&nbsp;()&nbsp;=&gt;&nbsp;void<br/>} | 否 | - | 确认按钮的文本内容、文本色、按钮背景色和点击回调。 |
   | cancel | ()&nbsp;=&gt;&nbsp;void | 否 | - | 点击遮障层关闭dialog时的回调。 |
-  | alignment | [DialogAlignment](ts-methods-custom-dialog-box.md) | 否 | DialogAlignment.Default | 弹窗在竖直方向上的对齐方式。 |
+  | alignment | [DialogAlignment](ts-methods-custom-dialog-box.md#dialogalignment枚举说明) | 否 | DialogAlignment.Default | 弹窗在竖直方向上的对齐方式。 |
   | offset | {<br/>dx:&nbsp;Length&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>dy:&nbsp;Length&nbsp;&nbsp;\|&nbsp;[Resource](ts-types.md#resource)<br/>} | 否 | - | 弹窗相对alignment所在位置的偏移量。 |
   | gridCount | number | 否 | - | 弹窗容器宽度所占用栅格数。 |
 
-- paramObject2参数
-  | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+## AlertDialogParamWithButtons对象说明
+  | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | 
   | -------- | -------- | -------- | -------- | -------- |
   | title | string&nbsp;\|&&nbsp;[Resource](ts-types.md#resource) | 否 | - | 弹窗标题。 |
   | message | string&nbsp;\|&&nbsp;[Resource](ts-types.md#resource) | 是 | - | 弹窗内容。 |
@@ -34,7 +34,7 @@
   | primaryButton | {<br/>value:&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>fontColor?:&nbsp;Color&nbsp;\|&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>backgroundColor?:&nbsp;Color&nbsp;\|&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>action:&nbsp;()&nbsp;=&gt;&nbsp;void;<br/>} | 否 | - | 按钮的文本内容、文本色、按钮背景色和点击回调。 |
   | secondaryButton | {<br/>value:&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>fontColor?:&nbsp;Color&nbsp;\|&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>backgroundColor?:&nbsp;Color&nbsp;\|&nbsp;number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>action:&nbsp;()&nbsp;=&gt;&nbsp;void;<br/>} | 否 | - | 按钮的文本内容、文本色、按钮背景色和点击回调。 |
   | cancel | ()&nbsp;=&gt;&nbsp;void | 否 | - | 点击遮障层关闭dialog时的回调。 |
-  | alignment | [DialogAlignment](ts-methods-custom-dialog-box.md) | 否 | DialogAlignment.Default | 弹窗在竖直方向上的对齐方式。 |
+  | alignment | [DialogAlignment](ts-methods-custom-dialog-box.md#dialogalignment枚举说明) | 否 | DialogAlignment.Default | 弹窗在竖直方向上的对齐方式。 |
   | offset | {<br/>dx:&nbsp;Length&nbsp;\|&nbsp;[Resource](ts-types.md#resource),<br/>dy:&nbsp;Length&nbsp;&nbsp;\|&nbsp;[Resource](ts-types.md#resource)<br/>} | 否 | - | 弹窗相对alignment所在位置的偏移量。 |
   | gridCount | number | 否 | - | 弹窗容器宽度所占用栅格数。 |
 

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

@@ -23,7 +23,7 @@ CustomDialogController(value:{builder: CustomDialog, cancel?: () => void, aut
   | customStyle | boolean | 否 | false | 弹窗容器样式是否自定义。 |
   | gridCount<sup>8+</sup> | number | 否 | - | 弹窗宽度占栅格宽度的个数。 |
   
-- DialogAlignment枚举说明
+## DialogAlignment枚举说明
   | 名称 | 描述 |
   | -------- | -------- |
   | Top | 垂直顶部对齐。 |

zh-cn/application-dev/reference/arkui-ts/ts-types.md

@@ -93,21 +93,21 @@
 
 | 名称   | 类型                           | 必填 | 说明                                                         |
 | ------ | ------------------------------ | ---- | ------------------------------------------------------------ |
-| size   | number                         | 否   | 设置文本尺寸，Length为number类型时，使用fp单位。             |
-| weight | number                         | 否   | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。 |
-| family | [FontWeight](ts-appendix-enums.md#fontweight) \| number \| string | 否   | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, sans-serif'。 |
-| style  | string \| Resource             | 否   | 设置文本的字体样式。                                         |
+| size   | [Length](#length)       | 否   | 设置文本尺寸，Length为number类型时，使用fp单位。             |
+| weight | [FontWeight](ts-appendix-enums.md#fontweight) \| number \| string                          | 否   | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。 |
+| family | string \| [Resource](#resource) | 否   | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, sans-serif'。 |
+| style  | [FontStyle](ts-appendix-enums.md#fontstyle)       | 否   | 设置文本的字体样式。                          |
 
 ## Area<sup>8+</sup>
 
 区域类型，用于存储元素所占区域信息
 
-| 名称           | 类型      | 说明                                              |
-| -------------- | -------- | ------------------------------------------------- |
-| width          | Length   | 目标元素的宽度，作为返回值时，类型为number，单位vp。  |
-| height         | Length   | 目标元素的高度，作为返回值时，类型为number，单位vp。  |
-| position       | Position | 目标元素左上角相对父元素左上角的位置。                |
-| globalPosition | Position | 目标元素左上角相对页面左上角的位置。                  |
+| 名称           | 类型      | 必填  | 说明                                              |
+| -------------- | -------- | ----- |------------------------------------------------- |
+| width          | [Length](#length)    |  是   |目标元素的宽度，作为返回值时，类型为number，单位vp。  |
+| height         | [Length](#length)    |  是   |目标元素的高度，作为返回值时，类型为number，单位vp。  |
+| position       | [Position](#position8) |  是   |目标元素左上角相对父元素左上角的位置。                |
+| globalPosition | [Position](#position8) |  是   |目标元素左上角相对页面左上角的位置。                  |
 
 
 ## Position<sup>8+</sup>

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

@@ -14,9 +14,9 @@
 
 | 名称 | 参数类型 | 默认值 | 描述 |
 | -------- | -------- | -------- | -------- |
-| linearGradient | {<br/>angle?:&nbsp;number\|string,<br/>direction?:&nbsp;[GradientDirection](ts-appendix-enums.md#gradientdirection),<br/>colors:&nbsp;Array&lt;any&gt;<br/>repeating?:&nbsp;boolean<br/>} | - | 线性渐变。<br/>angle:&nbsp;线性渐变的角度。<br/>direction:&nbsp;线性渐变的方向，设置angle后不生效。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
-| sweepGradient | {<br/>center:&nbsp;Point,<br/>start?:&nbsp;angle,<br/>end?:&nbsp;angle,<br/>colors:&nbsp;Array&lt;any&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;any&gt;<br/>repeating:&nbsp;boolean<br/>} | - | 径向渐变。<br/>center：径向渐变的中心点。<br/>radius：径向渐变的半径。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
+| linearGradient | {<br/>angle?:&nbsp;number\|string,<br/>direction?:&nbsp;[GradientDirection](ts-appendix-enums.md#gradientdirection),<br/>colors:&nbsp;Array&lt;Color&gt;<br/>, repeating?:&nbsp;boolean<br/>} | - | 线性渐变。<br/>angle:&nbsp;线性渐变的角度。<br/>direction:&nbsp;线性渐变的方向，设置angle后不生效。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
+| sweepGradient | {<br/>center:&nbsp;Point, <br/>start?:&nbsp;number\|string,<br/>end?:&nbsp;number\|string,rotation?:&nbsp;number\|string,<br/>colors:&nbsp;Array&lt;Color&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;number\|string,<br/>colors:&nbsp;Array&lt;Color&gt;<br/>, repeating:&nbsp;boolean<br/>} | - | 径向渐变。<br/>center：径向渐变的中心点。<br/>radius：径向渐变的半径。<br/>colors:&nbsp;为渐变的颜色描述。<br/>repeating:&nbsp;为渐变的颜色重复着色。 |
 
 
 ## 示例

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

@@ -16,7 +16,7 @@
 | ----------------------------- | ---------------------------------------- | ------ | ---------------------------------------- |
 | blur                          | number                                   | -      | 为当前组件添加内容模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。  |
 | backdropBlur                  | number                                   | -      | 为当前组件添加背景模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。  |
-| shadow                        | {<br/>radius:&nbsp;number,<br/>color?:&nbsp;Color,<br/>offsetX?:&nbsp;number,<br/>offsetY?:&nbsp;number<br/>} | -      | 为当前组件添加阴影效果，入参为模糊半径(必填)、阴影的颜色(可选，默认为灰色)、X轴的偏移量(可选，默认为0)，Y轴的偏移量(可选，默认为0)，偏移量单位为px。 |
+| shadow                        | {<br/>radius:&nbsp;number \| [Resource](ts-types.md#resource),<br/>color?:&nbsp;Color \| string \| Resource,<br/>offsetX?:&nbsp;number \| Resource,<br/>offsetY?:&nbsp;number \| Resource<br/>} | -      | 为当前组件添加阴影效果，入参为模糊半径(必填)、阴影的颜色(可选，默认为灰色)、X轴的偏移量(可选，默认为0)，Y轴的偏移量(可选，默认为0)，偏移量单位为px。 |
 | grayscale                     | number                                   | 0.0    | 为当前组件添加灰度效果。值定义为灰度转换的比例，入参1.0则完全转为灰度图像，入参则0.0图像无变化，入参在0.0和1.0之间时，效果呈线性变化。（百分比) |
 | brightness                    | number                                   | 1.0    | 为当前组件添加高光效果，入参为高光比例，值为1时没有效果，小于1时亮度变暗，0为全黑；大于1时亮度增加，数值越大亮度越大。 |
 | saturate                      | number                                   | 1.0    | 为当前组件添加饱和度效果，饱和度为颜色中的含色成分和消色成分(灰)的比例，入参为1时，显示原图像，大于1时含色成分越大，饱和度越大；小于1时消色成分越大，饱和度越小。（百分比） |

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

@@ -15,7 +15,7 @@
 
 | 名称    | 参数类型                                                     | 默认值                                                       | 描述                                             |
 | ------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------ |
-| overlay | title:&nbsp;string,<br/>options:&nbsp;{<br/>align?:&nbsp;[Alignment](ts-appendix-enums.md#alignment),<br/>offset?:&nbsp;{x:&nbsp;number,&nbsp;y:&nbsp;number}<br/>} | {<br/>align:&nbsp;Alignment.Center,<br/>offset:&nbsp;{0,&nbsp;0}<br/>} | 在当前组件上，增加遮罩文本，布局与当前组件相同。 |
+| overlay | value:&nbsp;string,<br/>options?:&nbsp;{<br/>align?:&nbsp;[Alignment](ts-appendix-enums.md#alignment-enums),&nbsp;<br/>offset?:&nbsp;{x?:&nbsp;number, y?:&nbsp;number}<br/>} | {<br/>align:&nbsp;Alignment.Center,<br/>offset:&nbsp;{0,&nbsp;0}<br/>} | 在当前组件上，增加遮罩文本，布局与当前组件相同。 |
 
 
 ## 示例

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

@@ -13,11 +13,10 @@
 ## 属性
 
 
-| 名称 | 参数类型 | 默认值 | 描述 | 
+| 名称 | 参数类型 | 默认值 | 描述 |
 | -------- | -------- | -------- | -------- |
-| clip | Shape \| boolean | false | 参数为Shape类型时，按指定的形状对当前组件进行裁剪；参数为boolean类型时，设置是否按照边缘轮廓进行裁剪。 | 
-| mask | Shape | - | 在当前组件上加上指定形状的遮罩。 | 
-
+| clip | [Circle](ts-drawing-components-circle.md) \| [Ellipse](ts-drawing-components-ellipse.md) \| [Path](ts-drawing-components-path.md) \| [Rect](ts-drawing-components-rect.md) \| boolean | false | 参数为相应类型的组件，按指定的形状对当前组件进行裁剪；参数为boolean类型时，设置是否按照边缘轮廓进行裁剪。 |
+| mask | [Circle](ts-drawing-components-circle.md) \| [Ellipse](ts-drawing-components-ellipse.md) \| [Path](ts-drawing-components-path.md) \| [Rect](ts-drawing-components-rect.md) | - | 在当前组件上加上指定形状的遮罩。 |
 
 ## 示例
 

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

@@ -8,13 +8,20 @@
 
 | 名称                                                         | 支持冒泡 | 功能描述                                                     |
 | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ |
-| onDragStart(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;&nbsp;[CustomBuilder](ts-types.md#custombuilder8)) | 否       | 第一次拖拽此事件绑定的组件时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。<br/>长按150毫秒(ms)可触发拖拽事件。优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 |
-| onDragEnter(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 拖拽进入组件范围内时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
-| onDragMove(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 拖拽在组件范围内移动时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
-| onDragLeave(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 拖拽离开组件范围内时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
-| onDrop(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。 |
+| onDragStart(event:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;&nbsp;[CustomBuilder](ts-types.md#custombuilder8)) \| DragItemInfo | 否       | 第一次拖拽此事件绑定的组件时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。<br/>长按150毫秒(ms)可触发拖拽事件。优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 |
+| onDragEnter(event:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 拖拽进入组件范围内时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
+| onDragMove(event:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 拖拽在组件范围内移动时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
+| onDragLeave(event:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 拖拽离开组件范围内时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
+| onDrop(event:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否       | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。 |
 
-- extraParam说明<br>
+## DragItemInfo说明
+  | 属性名称          | 属性类型   | 必填 | 描述                                       |
+  | ------------- | ------ | ------- |--------------------------------- |
+  | pixelMap | [PixelMap](../apis/js-apis-image.md#pixelmap7) |  否  | 设置拖拽过程中显示的图片。 |
+  | builder | [CustomBuilder](../../ui/ts-types.md#custombuilder8) |  否  | 使用自定义生成器进行绘图，如果设置了pixelMap，则忽略此值。 |
+  | extraInfo | string |  否  | 拖拽项的描述。 |
+
+## extraParam说明<br>
   用于返回组件在拖拽中需要用到的额外信息。
   extraParam是Json对象转换的string字符串，可以通过Json.parse转换的Json对象获取如下属性。
   | 属性名称          | 属性类型   | 描述                                       |