16479cherryPick3.2rel

Signed-off-by: N yamila <tianyu55@huawei.com>

16479cherryPick3.2rel
Signed-off-by: N yamila <tianyu55@huawei.com>
3fd9f8f0 · yamila · f8440e51 · 3fd9f8f0 · 3fd9f8f0
2 changed file
--- a/zh-cn/application-dev/reference/apis/js-apis-curve.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-curve.md
@@ -57,7 +57,7 @@ stepsCurve(count: number, end: boolean)：ICurve
 | 参数名 | 类型    | 必填 | 说明                                                         |
 | ------ | ------- | ----| ------------------------------------------------------------ |
-| count  | number  | 是   | 阶梯的数量，需要为正整数。                                   |
+| count  | number  | 是   | 阶梯的数量，需要为正整数。<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按值为0处理。 |
 | end    | boolean | 是   | 在每个间隔的起点或是终点发生阶跃变化。<br>-true：在终点发生阶跃变化。<br>-false：在起点发生阶跃变化。 |
 **返回值：**
@@ -85,12 +85,12 @@ cubicBezierCurve(x1: number, y1: number, x2: number, y2: number)：ICurve
 **系统能力：**  SystemCapability.ArkUI.ArkUI.Full
 **参数：**
-| 参数名  | 类型     | 必填   | 说明             |
+| 参数名 | 类型   | 必填 | 说明                                                         |
-| ---- | ------ | ---- | -------------- |
+| ------ | ------ | ---- | ------------------------------------------------------------ |
-| x1   | number | 是    | 确定贝塞尔曲线第一点横坐标。 |
+| x1     | number | 是   | 确定贝塞尔曲线第一点横坐标。<br/>取值范围：[0, 1]<br/>**说明：** <br/>设置的值小于0时，按0处理；设置的值大于1时，按1处理。 |
-| y1   | number | 是    | 确定贝塞尔曲线第一点纵坐标。 |
+| y1     | number | 是   | 确定贝塞尔曲线第一点纵坐标。<br/>取值范围：(-∞, +∞)          |
-| x2   | number | 是    | 确定贝塞尔曲线第二点横坐标。 |
+| x2     | number | 是   | 确定贝塞尔曲线第二点横坐标。<br/>取值范围：[0, 1]<br/>**说明：** <br/>设置的值小于0时，按0处理；设置的值大于1时，按1处理。 |
-| y2   | number | 是    | 确定贝塞尔曲线第二点纵坐标。 |
+| y2     | number | 是   | 确定贝塞尔曲线第二点纵坐标。<br/>取值范围：(-∞, +∞)          |
 **返回值：**
@@ -117,12 +117,12 @@ springCurve(velocity: number, mass: number, stiffness: number, damping: number)
 **系统能力：**  SystemCapability.ArkUI.ArkUI.Full
 **参数：**
-| 参数名       | 类型     | 必填   | 说明    |
+| 参数名    | 类型   | 必填 | 说明                                                         |
-| --------- | ------ | ---- | ----- |
+| --------- | ------ | ---- | ------------------------------------------------------------ |
-| velocity  | number | 是    | 初始速度。是由外部因素对弹性动效产生的影响参数，其目的是保证对象从之前的运动状态平滑的过渡到弹性动效。 |
+| velocity  | number | 是   | 初始速度。是由外部因素对弹性动效产生的影响参数，其目的是保证对象从之前的运动状态平滑的过渡到弹性动效。<br/>取值范围：(-∞, +∞) |
-| mass      | number | 是    | 质量。弹性系统的受力对象，会对弹性系统产生惯性影响。质量越大，震荡的幅度越大，恢复到平衡位置的速度越慢。 |
+| mass      | number | 是   | 质量。弹性系统的受力对象，会对弹性系统产生惯性影响。质量越大，震荡的幅度越大，恢复到平衡位置的速度越慢。<br/>取值范围：(0, +∞)<br/>**说明：** <br/>设置的值小于0时，按1处理。 |
-| stiffness | number | 是    | 刚度。是物体抵抗施加的力而形变的程度。在弹性系统中，刚度越大，抵抗变形的能力越强，恢复到平衡位置的速度就越快。 |
+| stiffness | number | 是   | 刚度。是物体抵抗施加的力而形变的程度。在弹性系统中，刚度越大，抵抗变形的能力越强，恢复到平衡位置的速度就越快。<br/>取值范围：(0, +∞)<br/>**说明：** <br/>设置的值小于0时，按1处理。 |
-| damping   | number | 是    | 阻尼。是一个纯数，无真实的物理意义，用于描述系统在受到扰动后震荡及衰减的情形。阻尼越大，弹性运动的震荡次数越少、震荡幅度越小。 |
+| damping   | number | 是   | 阻尼。是一个纯数，无真实的物理意义，用于描述系统在受到扰动后震荡及衰减的情形。阻尼越大，弹性运动的震荡次数越少、震荡幅度越小。<br/>取值范围：(0, +∞)<br/>**说明：** <br/>设置的值小于0时，按1处理。 |
 **返回值：**
@@ -131,7 +131,6 @@ springCurve(velocity: number, mass: number, stiffness: number, damping: number)
 | ---------------------------------- | ---------------- |
 |  [ICurve](#icurve)| 曲线的插值对象。 |
 **示例：**
 ```ts
@@ -151,16 +150,16 @@ springMotion(response?: number, dampingFraction?: number, overlapDuration?: numb
 **参数：**
 | 参数名       | 类型     | 必填   | 说明    |
 | --------- | ------ | ---- | ----- |
-| response  | number | 否    | 弹簧自然振动周期，决定弹簧复位的速度。单位：秒，默认值：0.55。 |
+| response  | number | 否    | 弹簧自然振动周期，决定弹簧复位的速度。<br/>默认值：0.55<br/>单位：秒<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按默认值0.55处理。 |
-| dampingFraction      | number | 否    | 阻尼系数。<br>0表示无阻尼，一直处于震荡状态；<br>大于0小于1的值为欠阻尼，运动过程中会超出目标值；<br>等于1为临界阻尼；<br>大于1为过阻尼，运动过程中逐渐趋于目标值。<br>默认值：0.825。 |
+| dampingFraction      | number | 否    | 阻尼系数。<br/>0表示无阻尼，一直处于震荡状态；<br/>大于0小于1的值为欠阻尼，运动过程中会超出目标值；<br/>等于1为临界阻尼；<br/>大于1为过阻尼，运动过程中逐渐趋于目标值。<br/>默认值：0.825<br/>单位：秒<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按默认值0.55处理。 |
-| overlapDuration | number | 否    | 弹性动画衔接时长。发生动画继承时，如果前后两个弹性动画response不一致，response参数会在overlapDuration时间内平滑过渡。单位：秒，默认值：0。 |
+| overlapDuration | number | 否    | 弹性动画衔接时长。发生动画继承时，如果前后两个弹性动画response不一致，response参数会在overlapDuration时间内平滑过渡。<br/>默认值：0<br/>单位：秒<br/>取值范围：[0, +∞)。<br/>**说明：** <br/>设置小于0的值时，按默认值0处理。<br/>弹性动画曲线为物理曲线，[animation](../arkui-ts/ts-animatorproperty.md)、[animateTo](../arkui-ts/ts-explicit-animation.md)中的duration参数不生效，动画持续时间取决于springMotion动画曲线参数和之前的速度。时间不能归一，故不能通过该曲线的interpolate函数获得插值。 |
 **返回值：**
 | 类型                           | 说明             |
 | ---------------------------------- | ---------------- |
-|  [ICurve](#icurve)| 曲线对象。<br>**说明:** 弹性动画曲线为物理曲线，animation、animateTo中的duration参数不生效，动画持续时间取决于springMotion动画曲线参数和之前的速度。时间不能归一，故不能通过该曲线的[interpolate](#interpolate)函数获得插值。 |
+|  [ICurve](#icurve)| 曲线对象。<br>**说明:** 弹性动画曲线为物理曲线，[animation](../arkui-ts/ts-animatorproperty.md)、[animateTo](../arkui-ts/ts-explicit-animation.md)中的duration参数不生效，动画持续时间取决于springMotion动画曲线参数和之前的速度。时间不能归一，故不能通过该曲线的[interpolate](#interpolate)函数获得插值。 |
 **示例：**
@@ -184,15 +183,15 @@ responsiveSpringMotion(response?: number, dampingFraction?: number, overlapDurat
 **参数：**
 | 参数名       | 类型     | 必填   | 说明    |
 | --------- | ------ | ---- | ----- |
-| response  | number | 否    | 解释同springMotion中的response。单位：秒，默认值：0.15。 |
+| response  | number | 否    | 解释同springMotion中的response。<br/>默认值：0.15<br/>单位：秒<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按默认值0.15处理。 |
-| dampingFraction      | number | 否    | 解释同springMotion中的dampingFraction。默认值：0.86。 |
+| dampingFraction      | number | 否    | 解释同springMotion中的dampingFraction。<br/>默认值：0.86<br/>单位：秒<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按默认值0.86处理。 |
-| overlapDuration | number | 否    | 解释同springMotion中的overlapDuration。单位：秒，默认值：0.25。 |
+| overlapDuration | number | 否    | 解释同springMotion中的overlapDuration。<br/>默认值：0.25<br/>单位：秒<br/>取值范围：[0, +∞)<br/>**说明：** <br/>设置小于0的值时，按默认值0.25处理。<br/>弹性跟手动画曲线为springMotion的一种特例，仅默认值不同。如果使用自定义参数的弹性曲线，推荐使用springMotion构造曲线。如果使用跟手动画，推荐使用默认参数的弹性跟手动画曲线。<br/>[animation](../arkui-ts/ts-animatorproperty.md)、[animateTo](../arkui-ts/ts-explicit-animation.md)中的duration参数不生效，动画持续时间取决于responsiveSpringMotion动画曲线参数和之前的速度，也不能通过该曲线的interpolate函数获得插值。 |
 **返回值：**
 | 类型                           | 说明             |
 | ---------------------------------- | ---------------- |
-|  [ICurve](#icurve)| 曲线对象。<br>**说明:** <br>1.弹性跟手动画曲线为springMotion的一种特例，仅默认值不同。如果使用自定义参数的弹性曲线，推荐使用springMotion构造曲线；如果使用跟手动画，推荐使用默认参数的弹性跟手动画曲线。<br>2.animation、animateTo中的duration参数不生效，动画持续时间取决于responsiveSpringMotion动画曲线参数和之前的速度，也不能通过该曲线的[interpolate](#interpolate)函数获得插值。 |
+|  [ICurve](#icurve)| 曲线对象。<br>**说明:** <br>1、弹性跟手动画曲线为springMotion的一种特例，仅默认值不同。如果使用自定义参数的弹性曲线，推荐使用springMotion构造曲线；如果使用跟手动画，推荐使用默认参数的弹性跟手动画曲线。<br/>2、[animation](../arkui-ts/ts-animatorproperty.md)、[animateTo](../arkui-ts/ts-explicit-animation.md)中的duration参数不生效，动画持续时间取决于responsiveSpringMotion动画曲线参数和之前的速度，也不能通过该曲线的[interpolate](#interpolate)函数获得插值。 |
 **示例：**
@@ -217,9 +216,9 @@ interpolate(fraction:&nbsp;number): number
 **参数：**
-| 参数名   | 类型   | 必填 | 说明                                         |
+| 参数名   | 类型   | 必填 | 说明                                                         |
-| -------- | ------ | ---- | -------------------------------------------- |
+| -------- | ------ | ---- | ------------------------------------------------------------ |
-| fraction | number | 是   | &nbsp;当前的归一化时间参数，有效值范围0到1。 |
+| fraction | number | 是   | &nbsp;当前的归一化时间参数。<br/>取值范围：[0,1]<br/>**说明：** <br/>设置的值小于0时，按0处理；设置的值大于1时，按1处理。 |
 **返回值：**

--- a/zh-cn/application-dev/reference/apis/js-apis-matrix4.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-matrix4.md
@@ -278,11 +278,11 @@ Matrix的平移函数，可以为当前矩阵增加x轴/Y轴/Z轴平移效果。
 **参数：**
-| 参数名 | 类型   | 必填 | 说明                                  |
+| 参数名 | 类型   | 必填 | 说明                                                         |
-| ------ | ------ | ---- | ------------------------------------- |
+| ------ | ------ | ---- | ------------------------------------------------------------ |
-| x      | number | 否   | x轴的平移距离，单位px。<br/>默认值：0 |
+| x      | number | 否   | x轴的平移距离。<br/>默认值：0<br/>单位px<br/>取值范围 (-∞, +∞) |
-| y      | number | 否   | y轴的平移距离，单位px。<br/>默认值：0 |
+| y      | number | 否   | y轴的平移距离，单位px。<br/>默认值：0<br/>单位px<br/>取值范围 (-∞, +∞) |
-| z      | number | 否   | z轴的平移距离，单位px。<br/>默认值：0 |
+| z      | number | 否   | z轴的平移距离，单位px。<br/>默认值：0<br/>单位px<br/>取值范围 (-∞, +∞) |
 **返回值：**
@@ -324,13 +324,13 @@ Matrix的缩放函数，可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。
 **参数：**
-| 参数名  | 类型   | 必填 | 说明                              |
+| 参数名  | 类型   | 必填 | 说明                                                         |
-| ------- | ------ | ---- | --------------------------------- |
+| ------- | ------ | ---- | ------------------------------------------------------------ |
-| x       | number | 否   | x轴的缩放倍数。<br/>默认值：1     |
+| x       | number | 否   | x轴的缩放倍数。x>1时以x轴方向放大，x<1时以x轴方向缩小。<br/>默认值：1<br/>取值范围 [0, +∞)<br/>**说明：** <br/>设置小于0的值时，按照默认值处理。 |
-| y       | number | 否   | y轴的缩放倍数。<br/>默认值：1     |
+| y       | number | 否   | y轴的缩放倍数。y>1时以y轴方向放大，y<1时以y轴方向缩小。<br/>默认值：1<br/>取值范围 [0, +∞)<br/>**说明：** <br/>设置小于0的值时，按照默认值处理。 |
-| z       | number | 否   | z轴的缩放倍数。<br/>默认值：1     |
+| z       | number | 否   | z轴的缩放倍数。z>1时以z轴方向放大，z<1时以z轴方向缩小。<br/>默认值：1<br/>取值范围 [0, +∞)<br/>**说明：** <br/>设置小于0的值时，按照默认值处理。 |
-| centerX | number | 否   | 变换中心点x轴坐标。<br/>默认值：0 |
+| centerX | number | 否   | 变换中心点x轴坐标。<br/>默认值：0<br/>取值范围 (-∞, +∞)      |
-| centerY | number | 否   | 变换中心点y轴坐标。<br/>默认值：0 |
+| centerY | number | 否   | 变换中心点y轴坐标。<br/>默认值：0<br/>取值范围 (-∞, +∞)      |
 **返回值：**
@@ -372,14 +372,14 @@ Matrix的旋转函数，可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。
 **参数：**
-| 参数名  | 类型   | 必填 | 说明                              |
+| 参数名  | 类型   | 必填 | 说明                                                  |
-| ------- | ------ | ---- | --------------------------------- |
+| ------- | ------ | ---- | ----------------------------------------------------- |
-| x       | number | 否   | 旋转轴向量x坐标。<br/>默认值：1   |
+| x       | number | 否   | 旋转轴向量x坐标。<br/>默认值：1<br/>取值范围 (-∞, +∞) |
-| y       | number | 否   | 旋转轴向量y坐标。<br/>默认值：1   |
+| y       | number | 否   | 旋转轴向量y坐标。<br/>默认值：1<br/>取值范围 (-∞, +∞) |
-| z       | number | 否   | 旋转轴向量z坐标。<br/>默认值：1   |
+| z       | number | 否   | 旋转轴向量z坐标。<br/>默认值：1<br/>取值范围 (-∞, +∞) |
-| angle   | number | 否   | 旋转角度。<br/>默认值：0          |
+| angle   | number | 否   | 旋转角度。<br/>默认值：0                              |
-| centerX | number | 否   | 变换中心点x轴坐标。<br/>默认值：0 |
+| centerX | number | 否   | 变换中心点x轴坐标。<br/>默认值：0                     |
-| centerY | number | 否   | 变换中心点y轴坐标。<br/>默认值：0 |
+| centerY | number | 否   | 变换中心点y轴坐标。<br/>默认值：0                     |
 **返回值：**