diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-gradient-color.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-gradient-color.md
index dbb228fb2b31c2b55d1cee7bda31fe62abc753d8..46cd390498c4132f4c4f78e4a8725d70b4a60507 100644
--- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-gradient-color.md
+++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-gradient-color.md
@@ -26,7 +26,7 @@ linearGradient(value: {angle?: number | string; direction?: GradientDirection; c
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| value | {
angle?: number \| string,
direction?: [GradientDirection](ts-appendix-enums.md#gradientdirection),
colors: Array<[[ResourceColor](ts-types.md#resourcecolor), number]>,
repeating?: boolean
} | 是 | 线性渐变。
取值范围:(-∞,+∞)
- angle:线性渐变的起始角度。0点方向顺时针旋转为正向角度。
默认值:180
角度为字符串时仅支持类型deg,grad,rad,turn。
- direction:线性渐变的方向,设置angle后不生效。
默认值:GradientDirection.Bottom
- [colors](#radialgradientoptions18对象说明):指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。
- repeating:为渐变的颜色重复着色。
默认值:false |
+| value | {
angle?: number \| string,
direction?: [GradientDirection](ts-appendix-enums.md#gradientdirection),
colors: Array<[[ResourceColor](ts-types.md#resourcecolor), number]>,
repeating?: boolean
} | 是 | 线性渐变。
- angle:线性渐变的起始角度。角度为0度时渐变方向为从下往上(即0点方向)。0点方向顺时针旋转为正向角度。
取值范围:(-∞,+∞)
默认值:180
角度为字符串时,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位,例如:"90"、 "90deg"、"1.57rad"。
- direction:线性渐变的方向,设置angle为非undefined后不生效。设置为GradientDirection.None时,按默认方向渐变。
默认值:GradientDirection.Bottom
- [colors](#radialgradientoptions18对象说明):指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。ResourceColor表示颜色,number表示该颜色所处的位置,取值范围为[0, 1.0],设置的值小于0时,按0处理,设置的值大于1.0时,按1.0处理。0表示需要设置渐变色的开始处,1.0表示渐变色的结束处。为了实现多个颜色渐变效果,多个数组中的number类型参数应递增设置。如果后一个数组中的number类型参数小于前一个数组的number类型参数,将按照等于前一个数组number值处理。
默认值:[],无渐变效果。
- repeating:为渐变的颜色重复着色。
默认值:false |
**返回值:**
@@ -68,9 +68,9 @@ linearGradient(options: Optional\): T
| 名称 | 类型 | 必填 | 说明 |
| ------------------------------------------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| angle | number \| string | 否 | 线性渐变的起始角度。0点方向顺时针旋转为正向角度。默认值:180。角度为字符串时仅支持类型deg,grad,rad,turn。|
-| direction | [GradientDirection](ts-appendix-enums.md#gradientdirection) | 否 | 线性渐变的方向,设置angle后不生效。默认值:GradientDirection.Bottom。|
-| [colors](#radialgradientoptions18对象说明) | Array[[ResourceColor](ts-types.md#resourcecolor), number] | 是 | 指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。|
+| angle | number \| string | 否 | 线性渐变的起始角度。角度为0度时渐变方向为从下往上(即0点方向)。0点方向顺时针旋转为正向角度。取值范围:(-∞,+∞) 默认值:180 角度为字符串时,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位,例如:"90"、 "90deg"、"1.57rad"。|
+| direction | [GradientDirection](ts-appendix-enums.md#gradientdirection) | 否 | 线性渐变的方向,设置angle为非undefined后不生效。设置为GradientDirection.None时,按默认方向渐变。默认值:GradientDirection.Bottom。|
+| [colors](#radialgradientoptions18对象说明) | Array[[ResourceColor](ts-types.md#resourcecolor), number] | 是 | 指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。ResourceColor表示颜色,number表示该颜色所处的位置,取值范围为[0, 1.0],设置的值小于0时,按0处理,设置的值大于1.0时,按1.0处理。0表示需要设置渐变色的开始处,1.0表示渐变色的结束处。为了实现多个颜色渐变效果,多个数组中的number类型参数应递增设置。如果后一个数组中的number类型参数小于前一个数组的number类型参数,将按照等于前一个数组number值处理。
默认值:[],无渐变效果。|
| repeating | boolean | 否 | 为渐变的颜色重复着色。
默认值:false。
true:允许为渐变的颜色重复着色。
false:不允许为渐变的颜色重复着色。|
## sweepGradient
@@ -89,7 +89,7 @@ sweepGradient(value: {center: [Length, Length]; start?: number | string; end?: n
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| value | {
center: [[Length](./ts-types.md#length), Length],
start?: number \| string,
end?: number \| string,
rotation?: number \| string,
colors: Array<[[ResourceColor](ts-types.md#resourcecolor), number]>,
repeating?: boolean
} | 是 | 角度渐变,仅绘制0-360度范围内的角度,超出时不绘制渐变色,只绘制纯色。
- center:为角度渐变的中心点,即相对于当前组件左上角的坐标。
- start:角度渐变的起点。
默认值:0
角度为字符串时仅支持类型deg,grad,rad,turn。
- end:角度渐变的终点。
默认值:0
角度为字符串时仅支持类型deg,grad,rad,turn。
- rotation:角度渐变的旋转角度。
默认值:0
角度为字符串时仅支持类型deg,grad,rad,turn。
- [colors](#radialgradientoptions18对象说明):指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。
- repeating:为渐变的颜色重复着色。
默认值:false。
true:允许为渐变的颜色重复着色。
false:不允许为渐变的颜色重复着色。
**说明:**
设置为小于0的值时,按值为0处理,设置为大于360的值时,按值为360处理。
当start、end、rotation的数据类型为string,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位,例如:"90"、 "90deg"、"1.57rad"。 |
+| value | {
center: [[Length](./ts-types.md#length), Length],
start?: number \| string,
end?: number \| string,
rotation?: number \| string,
colors: Array<[[ResourceColor](ts-types.md#resourcecolor), number]>,
repeating?: boolean
} | 是 | 角度渐变,仅绘制0-360度范围内的角度,超出时不绘制渐变色,只绘制纯色。
- center:为角度渐变的中心点,即相对于当前组件左上角的坐标。
- start:角度渐变的起点。
默认值:0
角度为字符串时仅支持类型deg,grad,rad,turn。
- end:角度渐变的终点。
默认值:0
角度为字符串时仅支持类型deg,grad,rad,turn。
- rotation:角度渐变的旋转角度。
默认值:0
角度为字符串时仅支持类型deg,grad,rad,turn。
- [colors](#radialgradientoptions18对象说明):指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。ResourceColor表示颜色,number表示该颜色所处的位置,取值范围为[0, 1.0],设置的值小于0时,按0处理,设置的值大于1.0时,按1.0处理。0表示需要设置渐变色的开始处,1.0表示渐变色的结束处。为了实现多个颜色渐变效果,多个数组中的number类型参数应递增设置。如果后一个数组中的number类型参数小于前一个数组的number类型参数,将按照等于前一个数组number值处理。
默认值:[],无渐变效果。
- repeating:为渐变的颜色重复着色。
默认值:false。
true:允许为渐变的颜色重复着色。
false:不允许为渐变的颜色重复着色。
**说明:**
设置为小于0的值时,按值为0处理,设置为大于360的值时,按值为360处理。
当start、end、rotation的数据类型为string,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位,例如:"90"、 "90deg"、"1.57rad"。 |
**返回值:**
@@ -130,9 +130,9 @@ sweepGradient(options: Optional\): T
| 名称 | 类型 | 必填 | 说明 |
| ------------------------------------------ | ------------------------------------------------------------ | ---- |------------------------------------------------------------- |
| center | [[Length](./ts-types.md#length), Length] | 是 | 为角度渐变的中心点,即相对于当前组件左上角的坐标。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
-| start | number \| string | 否 | 角度渐变的起点。 默认值:0。
角度为字符串时仅支持类型deg,grad,rad,turn。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
-| end | number \| string | 否 | 角度渐变的终点。 默认值:0。
角度为字符串时仅支持类型deg,grad,rad,turn。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
-| rotation | number \| string | 否 | 角度渐变的旋转角度。默认值:0。
角度为字符串时仅支持类型deg,grad,rad,turn。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
+| start | number \| string | 否 | 角度渐变的起点。 默认值:0。
角度为字符串时,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位。例如:"90"、 "90deg"、"1.57rad"。取值有0~360度的限制,转换为度的单位之后,值在0~360度之间,设置为小于0度的值时,按值为0度处理,设置为大于360度的值时,按值为360度处理。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
+| end | number \| string | 否 | 角度渐变的终点。 默认值:0。
角度为字符串时,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位。例如:"90"、 "90deg"、"1.57rad"。取值有0~360度的限制,转换为度的单位之后,值在0~360度之间,设置为小于0度的值时,按值为0度处理,设置为大于360度的值时,按值为360度处理。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
+| rotation | number \| string | 否 | 角度渐变的旋转角度。默认值:0。
角度为字符串时,合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位。例如:"90"、 "90deg"、"1.57rad"。取值有0~360度的限制,转换为度的单位之后,值在0~360度之间,设置为小于0度的值时,按值为0度处理,设置为大于360度的值时,按值为360度处理。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
| colors | Array<[[ResourceColor](ts-types.md#resourcecolor), number] | 是 | 指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
| metricsColors20+ | Array<[[ColorMetrics](../js-apis-arkui-graphics.md#colormetrics12), number] | 否 | 指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。设置metricsColors时colors失效。每个渐变ColorMetrics的色域属性应当统一,设置不同色域属性则认为非法。默认值为透明色。
**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 |
| repeating | boolean | 否 | 为渐变的颜色重复着色。
默认值:false
true:允许为渐变的颜色重复着色。
false:不允许为渐变的颜色重复着色。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
@@ -159,7 +159,7 @@ radialGradient(value: { center: [Length, Length]; radius: number | string; color
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| value | {
center: [[Length](./ts-types.md#length), Length],
radius: number \| string,
colors: Array<[[ResourceColor](ts-types.md#resourcecolor), number]>,
repeating?: boolean
} | 是 | 径向渐变。
- center:径向渐变的中心点,即相对于当前组件左上角的坐标。
- radius:径向渐变的半径。
取值范围:[0,+∞)
**说明:**
设置为小于的0值时,按值为0处理。
- [colors](#radialgradientoptions18对象说明):指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。
- repeating:为渐变的颜色重复着色。
默认值:false。
true:允许为渐变的颜色重复着色。
false:不允许为渐变的颜色重复着色。 |
+| value | {
center: [[Length](./ts-types.md#length), Length],
radius: number \| string,
colors: Array<[[ResourceColor](ts-types.md#resourcecolor), number]>,
repeating?: boolean
} | 是 | 径向渐变。
- center:径向渐变的中心点,即相对于当前组件左上角的坐标。
- radius:径向渐变的半径。
取值范围:[0,+∞)
**说明:**
设置的值小于0时,按值为0处理。 设置的值为undefined时,系统会自适应渐变半径。
- [colors](#radialgradientoptions18对象说明):指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。ResourceColor表示颜色,number表示该颜色所处的位置,取值范围为[0, 1.0],设置的值小于0时,按0处理,设置的值大于1.0时,按1.0处理。0表示需要设置渐变色的开始处,1.0表示渐变色的结束处。为了实现多个颜色渐变效果,多个数组中的number类型参数应递增设置。如果后一个数组中的number类型参数小于前一个数组的number类型参数,将按照等于前一个数组number值处理。
默认值:[],无渐变效果。
- repeating:为渐变的颜色重复着色。
默认值:false。
true:允许为渐变的颜色重复着色。
false:不允许为渐变的颜色重复着色。 |
**返回值:**
@@ -203,7 +203,7 @@ radialGradient(options: Optional\): T
| 名称 | 类型 | 必填 | 说明 |
| --------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------ |
| center | [[Length](./ts-types.md#length), Length] | 是 | 径向渐变的中心点,即相对于当前组件左上角的坐标。 |
-| radius | [Length](./ts-types.md#length) | 是 | 径向渐变的半径。
取值范围:[0,+∞) |
+| radius | [Length](./ts-types.md#length) | 是 | 径向渐变的半径。
取值范围:[0,+∞)。设置的值小于0时,按值为0处理。设置的值为undefined时,系统会自适应渐变半径。 |
| colors | Array<[[ResourceColor](ts-types.md#resourcecolor), number]> | 是 | 指定渐变色颜色和其对应的百分比位置的数组,设置非法颜色直接跳过。 |
| repeating | boolean | 否 | 为渐变的颜色重复着色。默认值:false。 |