鸿蒙NEXT开辟：ArkTS组件-通用属性（颜色渐变）
往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）[*] 鸿蒙开辟焦点知识点，看这篇文章就够了
[*] 最新版！鸿蒙HarmonyOS Next应用开辟实战学习门路
[*] 鸿蒙HarmonyOS NEXT开辟技能最全学习门路指南
[*] 鸿蒙应用开辟实战项目，看这一篇文章就够了（部分项目附源码）
颜色渐变
设置组件的颜色渐变效果。
说明
从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
颜色渐变属于组件内容，绘制在配景上方。
颜色渐变不支持宽高显式动画，实行宽高动画时颜色渐变会直接过渡到尽头。
linearGradient
linearGradient(value: {angle?: number | string; direction?: GradientDirection; colors: Array<>; repeating?: boolean;})
线性渐变。
卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。
元服务API： 从API version 11开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名类型必填说明value {
angle?: number | string,
direction?: GradientDirection,
colors: Array<>,
repeating?: boolean
}
是 线性渐变。
- angle: 线性渐变的起始角度。0点方向顺时针旋转为正向角度。
默认值：180
角度为字符串时仅支持类型deg，grad，rad，trun。
- direction: 线性渐变的方向，设置angle后不见效。
默认值：GradientDirection.Bottom
- colors: 指定渐变色颜色和其对应的百分比位置的数组，设置非法颜色直接跳过。
- repeating: 为渐变的颜色重复着色。
默认值：false
sweepGradient
sweepGradient(value: {center: ; start?: number | string; end?: number | string; rotation?: number | string; colors: Array<>; repeating?: boolean;})
角度渐变。
元服务API： 从API version 11开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。
参数：
参数名类型必填说明value {
center: ,
start?: number | string,
end?: number | string,
rotation?: number | string,
colors: Array<>,
repeating?: boolean
}
是 角度渐变，仅绘制0-360度范围内的角度，超出时不绘制渐变色，只绘制纯色。
- center：为角度渐变的中心点，即相对于当前组件左上角的坐标。
- start：角度渐变的起点。
默认值：0
角度为字符串时仅支持类型deg，grad，rad，trun。
- end：角度渐变的尽头。
默认值：0
角度为字符串时仅支持类型deg，grad，rad，trun。
- rotation: 角度渐变的旋转角度。
默认值：0
角度为字符串时仅支持类型deg，grad，rad，trun。
- colors: 指定渐变色颜色和其对应的百分比位置的数组，设置非法颜色直接跳过。
- repeating: 为渐变的颜色重复着色。
默认值：false
说明：
设置为小于0的值时，按值为0处理，设置为大于360的值时，按值为360处理。
当start、end、rotation的数据类型为string，合法的取值为纯数字或纯数字后带"deg"(度)、"rad"(弧度)、"grad"(梯度)、"turn"(圈)单位，比方："90"、 "90deg"、"1.57rad"。
radialGradient
radialGradient(value: { center: ; radius: number | string; colors: Array<>; repeating?: boolean })
径向渐变。
元服务API： 从API version 11开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。
参数：
参数名类型必填说明value {
center: ,
radius: number | string,
colors: Array<>,
repeating?: boolean
}
是 径向渐变。
- center：径向渐变的中心点，即相对于当前组件左上角的坐标。
- radius：径向渐变的半径。
取值范围：[0,+∞)
说明：
设置为小于的0值时，按值为0处理。
- colors: 指定渐变色颜色和其对应的百分比位置的数组，设置非法颜色直接跳过。
- repeating: 为渐变的颜色重复着色。
默认值：false
说明
colors参数的约束：
ResourceColor表示添补的颜色，number表示指定颜色所处的位置，取值范围为，0表示需要设置渐变色的容器的开始处，1.0表示容器的结尾处。想要实现多个颜色渐变效果时，多个数组中number参数建议递增设置，如后一个数组number参数比前一个数组number小的话，按照等于前一个数组number的值处理。
示例
示例1（颜色从右向左线性渐变）
该示例通过linearGradient来实现组件颜色线性渐变。
// xxx.ets
@Entry
@Component
struct ColorGradientExample {
build() {
Column({ space: 5 }) {
Text('linearGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
Row()
.width('90%')
.height(50)
.linearGradient({
angle: 90,
colors: [, , ]
})
Text('linearGradient Repeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
Row()
.width('90%')
.height(50)
.linearGradient({
direction: GradientDirection.Left, // 渐变方向
repeating: true, // 渐变颜色是否重复
colors: [, , ] // 数组末尾元素占比小于1时满足重复着色效果
})
}
.width('100%')
.padding({ top: 5 })
}
}
https://i-blog.csdnimg.cn/img_convert/76bf909c0c1cff9e6624a6e2a2e4c6f4.png
示例2（颜色按旋转角度渐变）
该示例通过sweepGradient来实现组件颜色旋转角度渐变。
@Entry
@Component
struct ColorGradientExample {
build() {
Column({ space: 5 }) {
Text('sweepGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
Row()
.width(100)
.height(100)
.sweepGradient({
center: ,
start: 0,
end: 359,
colors: [, , ]
})
Text('sweepGradient Reapeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
Row()
.width(100)
.height(100)
.sweepGradient({
center: ,
start: 0,
end: 359,
rotation: 45, // 旋转角度
repeating: true, // 渐变颜色是否重复
colors: [, , ] // 数组末尾元素占比小于1时满足重复着色效果
})
}
.width('100%')
.padding({ top: 5 })
}
}
https://i-blog.csdnimg.cn/img_convert/8c76455421352c219e6b96ab6206b991.png
示例3（颜色按径向渐变）
该示例通过radialGradient来实现组件颜色径向渐变。
// xxx.ets
@Entry
@Component
struct ColorGradientExample {
build() {
Column({ space: 5 }) {
Text('radialGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
Row()
.width(100)
.height(100)
.radialGradient({
center: ,
radius: 60,
colors: [, , ]
})
Text('radialGradient Repeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
Row()
.width(100)
.height(100)
.radialGradient({
center: ,
radius: 60,
repeating: true,
colors: [, , ] // 数组末尾元素占比小于1时满足重复着色效果
})
}
.width('100%')
.padding({ top: 5 })
}
}
https://i-blog.csdnimg.cn/img_convert/d10cf8c8b9e85d425328d05cd4161577.png
https://i-blog.csdnimg.cn/direct/15ac2b59ab5c4731b627927d56a75698.png
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]