!17344 补充ArkTS卡片支持说明

Merge pull request !17344 from zhongjianfei/rr0417

!17344 补充ArkTS卡片支持说明
Merge pull request !17344 from zhongjianfei/rr0417
e9390e97 · openharmony_ci · Gitee · 132418f6 · d3b1a14e · e9390e97
9 changed file
--- a/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md
@@ -54,8 +54,6 @@

 ## TouchType

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称   | 描述                           |
 | ------ | ------------------------------ |
 | Down   | 手指按下时触发。               |
@@ -65,8 +63,6 @@

 ## MouseButton

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称    | 描述             |
 | ------- | ---------------- |
 | Left    | 鼠标左键。       |
@@ -78,8 +74,6 @@

 ## MouseAction

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称    | 描述           |
 | ------- | -------------- |
 | Press   | 鼠标按键按下。 |
@@ -109,8 +103,6 @@

 ## AnimationStatus

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称    | 描述               |
 | ------- | ------------------ |
 | Initial | 动画初始状态。     |
@@ -120,8 +112,6 @@

 ## FillMode

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称      | 描述                                                         |
 | --------- | ------------------------------------------------------------ |
 | None      | 动画未执行时不会将任何样式应用于目标，动画播放完成之后恢复初始默认状态。 |
@@ -142,8 +132,6 @@

 ## KeyType

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称 | 描述       |
 | ---- | ---------- |
 | Down | 按键按下。 |
@@ -151,8 +139,6 @@

 ## KeySource

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称     | 描述                 |
 | -------- | -------------------- |
 | Unknown  | 输入设备类型未知。   |
@@ -172,8 +158,6 @@

 ## Week

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称     | 描述                   |
 | -------- | ---------------------- |
 | Mon      | 星期一                |
@@ -242,8 +226,6 @@

 ## RelateType

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称   | 描述                              |
 | ------ | ------------------------------- |
 | FILL    | 缩放当前子组件以填充满父组件      |
@@ -384,8 +366,6 @@

 ## SharedTransitionEffectType

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称        | 描述       |
 | ----------- | ---------- |
 | Static        | 目标页面元素的位置保持不变，可以配置透明度动画。目前，只有为重定向到目标页面而配置的静态效果才会生效。 |
@@ -456,8 +436,6 @@

 ## ResponseType<sup>8+</sup>

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称       | 描述                       |
 | ---------- | -------------------------- |
 | LongPress  | 通过长按触发菜单弹出。     |
@@ -465,8 +443,6 @@

 ## HoverEffect<sup>8+</sup>

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称      | 描述                         |
 | --------- | ---------------------------- |
 | Auto      | 使用组件的系统默认悬浮效果。 |
@@ -476,8 +452,6 @@

 ## Placement<sup>8+</sup>

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称          | 描述                                                         |
 | ------------- | ------------------------------------------------------------ |
 | Left          | 气泡提示位于组件左侧，与组件左侧中心对齐。                   |
@@ -505,11 +479,10 @@

 ## HitTestMode<sup>9+</sup>

-从API version 9开始，该接口支持在ArkTS卡片中使用。
-
 | 名称        | 描述                 |
 | ----------- | -------------------- |
 | Default     | 自身节点和子节点都响应触摸事件的命中测试，但会阻止被该节点屏蔽的其他节点的命中测试。   |
 | Block       | 自身节点响应触摸事件的命中测试，但阻止被该节点屏蔽的子节点和其他节点的命中测试。        |
 | Transparent | 自身节点和子节点响应触摸事件的命中测试，并允许对被该节点屏蔽的其他节点进行命中测试。 |
 | None        | 自身节点不会响应触摸事件的命中测试，但子节点会对触摸事件进行命中测试。 |
+
--- a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
--- a/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md
@@ -88,6 +88,8 @@ onLayout?(children: Array&lt;LayoutChild&gt;, constraint: ConstraintSizeOptions)

 框架会在自定义组件布局时，将该自定义组件的子节点信息和自身的尺寸范围通过onLayout传递给该自定义组件。不允许在onLayout函数中改变状态变量。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 **参数：**

 | 参数名        | 类型                                       | 说明               |
@@ -102,6 +104,8 @@ onMeasure?(children: Array&lt;LayoutChild&gt;, constraint: ConstraintSizeOptions

 框架会在自定义组件确定尺寸时，将该自定义组件的子节点信息和自身的尺寸范围通过onMeasure传递给该自定义组件。不允许在onMeasure函数中改变状态变量。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 **参数：**

 | 参数名        | 类型                                       | 说明               |
@@ -114,6 +118,8 @@ onMeasure?(children: Array&lt;LayoutChild&gt;, constraint: ConstraintSizeOptions

 子组件布局信息。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 | 参数         | 参数类型                                     | 描述                  |
 | ---------- | ---------------------------------------- | ------------------- |
 | name       | string                                   | 子组件名称。              |
@@ -129,6 +135,8 @@ onMeasure?(children: Array&lt;LayoutChild&gt;, constraint: ConstraintSizeOptions

 子组件border信息。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 | 参数          | 参数类型                                 | 描述                      |
 | ----------- | ------------------------------------ | ----------------------- |
 | borderWidth | [EdgeWidths](ts-types.md#edgewidths) | 边框宽度类型，用于描述组件边框不同方向的宽度。 |
@@ -140,6 +148,8 @@ onMeasure?(children: Array&lt;LayoutChild&gt;, constraint: ConstraintSizeOptions

 子组件layout信息。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 | 参数         | 参数类型                                     | 描述       |
 | ---------- | ---------------------------------------- | -------- |
 | position   | [Position](ts-types.md#position)         | 子组件位置坐标。 |

--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
@@ -21,7 +21,7 @@

 Shape(value?: PixelMap)

-从API version 9开始，该接口支持在ArkTS卡片中使用。
+从API version 9开始，该接口支持在ArkTS卡片中使用，卡片中不支持使用PixelMap对象。

 **参数：**

@@ -52,8 +52,6 @@ Shape(value?: PixelMap)

 ## 示例

-### 示例1
-
 ```ts
 // xxx.ets
 @Entry

--- a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
--- a/zh-cn/application-dev/reference/arkui-ts/ts-state-management.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-state-management.md
@@ -752,6 +752,8 @@ abstract get(): T

 读取从AppStorage/LocalStorage同步属性的数据。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 **返回值：**

 | 类型   | 描述                              |
@@ -770,9 +772,10 @@ prop1.get(); //  prop1.get()=47

 abstract set(newValue: T): void

-
 设置AppStorage/LocalStorage同步属性的数据。

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+

 **参数：**


--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
@@ -10,18 +10,18 @@
 ## 属性


-| 名称                            | 参数类型                                     | 默认值    | 描述                                       |
-| ----------------------------- | ---------------------------------------- | ------ | ---------------------------------------- |
-| blur                          | number                                   | -      | 为当前组件添加内容模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。<br/>取值范围：[0, +∞)<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| backdropBlur                  | number                                   | -      | 为当前组件添加背景模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。<br/>取值范围：[0, +∞)<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| shadow                        | {<br/>radius:&nbsp;number \| [Resource](ts-types.md#resource),<br/>color?:&nbsp;[Color](ts-appendix-enums.md#color) \| string \| [Resource](ts-types.md#resource),<br/>offsetX?:&nbsp;number \| [Resource](ts-types.md#resource),<br/>offsetY?:&nbsp;number \| [Resource](ts-types.md#resource)<br/>} | -      | 为当前组件添加阴影效果。<br/>入参类型为ShadowOptions时，可以指定模糊半径、阴影的颜色、X轴和Y轴的偏移量。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。<br/>**说明：**<br/>ArkTS卡片上不支持参数为 [ShadowStyle](#shadowstyle10枚举说明)类型。 |
-| grayscale                     | number                                   | 0.0    | 为当前组件添加灰度效果。值定义为灰度转换的比例，入参1.0则完全转为灰度图像，入参则0.0图像无变化，入参在0.0和1.0之间时，效果呈线性变化。（百分比)<br/>取值范围：[0, 1]<br/>**说明：** <br/>设置小于0的值时，按值为0处理，设置大于1的值时，按值为1处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| brightness                    | number                                   | 1.0    | 为当前组件添加高光效果，入参为高光比例，值为1时没有效果，小于1时亮度变暗，0为全黑，大于1时亮度增加，数值越大亮度越大。<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| saturate                      | number                                   | 1.0    | 为当前组件添加饱和度效果，饱和度为颜色中的含色成分和消色成分(灰)的比例，入参为1时，显示原图像，大于1时含色成分越大，饱和度越大，小于1时消色成分越大，饱和度越小。（百分比）<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| contrast                      | number                                   | 1.0    | 为当前组件添加对比度效果，入参为对比度的值。值为1时，显示原图，大于1时，值越大对比度越高，图像越清晰醒目，小于1时，值越小对比度越低，当对比度为0时，图像变为全灰。（百分比）<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| invert                        | number                                   | 0      | 反转输入的图像。入参为图像反转的比例，值为1时完全反转，值为0则图像无变化。（百分比）<br/>取值范围：[0, 1]<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| sepia                         | number                                   | 0      | 将图像转换为深褐色。入参为图像反转的比例，值为1则完全是深褐色的，值为0图像无变化。&nbsp;（百分比）<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
-| hueRotate                     | number&nbsp;\|&nbsp;string               | '0deg' | 色相旋转效果，输入参数为旋转角度。<br/>取值范围：(-∞, +∞)<br/>**说明：** <br/>色调旋转360度会显示原始颜色。先将色调旋转180 度，然后再旋转-180度会显示原始颜色。数据类型为number时，值为90和'90deg'效果一致。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| 名称                          | 参数类型                                                     | 默认值 | 描述                                                         |
+| ----------------------------- | ------------------------------------------------------------ | ------ | ------------------------------------------------------------ |
+| blur                          | number                                                       | -      | 为当前组件添加内容模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。<br/>取值范围：[0, +∞)<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| backdropBlur                  | number                                                       | -      | 为当前组件添加背景模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。<br/>取值范围：[0, +∞)<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| shadow                        | {<br/>radius:&nbsp;number \| [Resource](ts-types.md#resource),<br/>color?:&nbsp;[Color](ts-appendix-enums.md#color) \| string \| [Resource](ts-types.md#resource),<br/>offsetX?:&nbsp;number \| [Resource](ts-types.md#resource),<br/>offsetY?:&nbsp;number \| [Resource](ts-types.md#resource)<br/>} | -      | 为当前组件添加阴影效果。<br/>入参类型为ShadowOptions时，可以指定模糊半径、阴影的颜色、X轴和Y轴的偏移量。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。<br/> |
+| grayscale                     | number                                                       | 0.0    | 为当前组件添加灰度效果。值定义为灰度转换的比例，入参1.0则完全转为灰度图像，入参则0.0图像无变化，入参在0.0和1.0之间时，效果呈线性变化。（百分比)<br/>取值范围：[0, 1]<br/>**说明：** <br/>设置小于0的值时，按值为0处理，设置大于1的值时，按值为1处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| brightness                    | number                                                       | 1.0    | 为当前组件添加高光效果，入参为高光比例，值为1时没有效果，小于1时亮度变暗，0为全黑，大于1时亮度增加，数值越大亮度越大。<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| saturate                      | number                                                       | 1.0    | 为当前组件添加饱和度效果，饱和度为颜色中的含色成分和消色成分(灰)的比例，入参为1时，显示原图像，大于1时含色成分越大，饱和度越大，小于1时消色成分越大，饱和度越小。（百分比）<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| contrast                      | number                                                       | 1.0    | 为当前组件添加对比度效果，入参为对比度的值。值为1时，显示原图，大于1时，值越大对比度越高，图像越清晰醒目，小于1时，值越小对比度越低，当对比度为0时，图像变为全灰。（百分比）<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| invert                        | number                                                       | 0      | 反转输入的图像。入参为图像反转的比例，值为1时完全反转，值为0则图像无变化。（百分比）<br/>取值范围：[0, 1]<br/>**说明：** <br/>设置小于0的值时，按值为0处理。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| sepia                         | number                                                       | 0      | 将图像转换为深褐色。入参为图像反转的比例，值为1则完全是深褐色的，值为0图像无变化。&nbsp;（百分比）<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| hueRotate                     | number&nbsp;\|&nbsp;string                                   | '0deg' | 色相旋转效果，输入参数为旋转角度。<br/>取值范围：(-∞, +∞)<br/>**说明：** <br/>色调旋转360度会显示原始颜色。先将色调旋转180 度，然后再旋转-180度会显示原始颜色。数据类型为number时，值为90和'90deg'效果一致。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | colorBlend&nbsp;<sup>8+</sup> | [Color](ts-appendix-enums.md#color)&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | -      | 为当前组件添加颜色叠加效果，入参为叠加的颜色。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |

 ## ShadowOptions对象说明

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md
@@ -13,13 +13,13 @@

 | 名称         | 参数类型                                      | 描述                                    |
 | -----------| ---------------------------------------- | ------------------------------------ |
-| fontColor  | [ResourceColor](ts-types.md#resourcecolor)  | 设置字体颜色。                                 |
-| fontSize   | [Length](ts-types.md#length)  | 设置字体大小，Length为number类型时，使用fp单位。字体默认大小16。不支持设置百分比字符串。    |
-| fontStyle  | [FontStyle](ts-appendix-enums.md#fontstyle)  | 设置字体样式。<br>默认值：FontStyle.Normal         |
-| fontWeight | number&nbsp;\|&nbsp;[FontWeight](ts-appendix-enums.md#fontweight)&nbsp;\|&nbsp;string  | 设置文本的字体粗细，number类型取值[100,&nbsp;900]，取值间隔为100，默认为400，取值越大，字体越粗。string类型仅支持number类型取值的字符串形式，例如"400"，以及"bold"、"bolder"、"lighter"、"regular"、"medium"，分别对应FontWeight中相应的枚举值。<br/>默认值：FontWeight.Normal  |
-| fontFamily | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource)  | 设置字体列表。默认字体'HarmonyOS Sans'，且当前只支持这种字体。|
-| lineHeight | string&nbsp;\|&nbsp;number&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 设置文本的文本行高，设置值不大于0时，不限制文本行高，自适应字体大小，Length为number类型时单位为fp。 |
-| decoration | {<br/>type:&nbsp;[TextDecorationType](ts-appendix-enums.md#textdecorationtype),<br/>color?:&nbsp;[ResourceColor](ts-types.md#resourcecolor)<br/>} | 设置文本装饰线样式及其颜色。<br />默认值：{<br/>type:&nbsp;TextDecorationType.None,<br/>color：Color.Black<br/>} |
+| fontColor  | [ResourceColor](ts-types.md#resourcecolor)  | 设置字体颜色。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| fontSize   | [Length](ts-types.md#length)  | 设置字体大小，Length为number类型时，使用fp单位。字体默认大小16。不支持设置百分比字符串。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| fontStyle  | [FontStyle](ts-appendix-enums.md#fontstyle)  | 设置字体样式。<br>默认值：FontStyle.Normal<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| fontWeight | number&nbsp;\|&nbsp;[FontWeight](ts-appendix-enums.md#fontweight)&nbsp;\|&nbsp;string  | 设置文本的字体粗细，number类型取值[100,&nbsp;900]，取值间隔为100，默认为400，取值越大，字体越粗。string类型仅支持number类型取值的字符串形式，例如"400"，以及"bold"、"bolder"、"lighter"、"regular"、"medium"，分别对应FontWeight中相应的枚举值。<br/>默认值：FontWeight.Normal<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| fontFamily | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource)  | 设置字体列表。默认字体'HarmonyOS Sans'，且当前只支持这种字体。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| lineHeight | string&nbsp;\|&nbsp;number&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 设置文本的文本行高，设置值不大于0时，不限制文本行高，自适应字体大小，Length为number类型时单位为fp。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
+| decoration | {<br/>type:&nbsp;[TextDecorationType](ts-appendix-enums.md#textdecorationtype),<br/>color?:&nbsp;[ResourceColor](ts-types.md#resourcecolor)<br/>} | 设置文本装饰线样式及其颜色。<br />默认值：{<br/>type:&nbsp;TextDecorationType.None,<br/>color：Color.Black<br/>}<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |


 ## 示例

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
@@ -29,6 +29,8 @@

 ## EventTarget<sup>8+</sup>对象说明

+从API version 9开始，该接口支持在ArkTS卡片中使用。
+
 | 名称   | 参数类型                      | 描述         |
 | ---- | ------------------------- | ---------- |
 | area | [Area](ts-types.md#area8) | 目标元素的区域信息。 |