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。 |