颜色渐变

2024-01-22 16:17 更新

设置组件的颜色渐变效果。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

属性

名称

参数

描述

linearGradient

{

angle?: number | string,

direction?: GradientDirection,

colors: Array<[ResourceColor, number]>,

repeating?: boolean

}

线性渐变。

- angle: 线性渐变的起始角度。0点方向顺时针旋转为正向角度。

默认值:180

- direction: 线性渐变的方向,设置angle后不生效。

默认值:GradientDirection.Bottom

- colors: 为渐变的颜色描述。

- repeating: 为渐变的颜色重复着色。

默认值:false

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

sweepGradient

{

center: Point,

start?: number | string,

end?: number | string,

rotation?: number|string,

colors: Array<[ResourceColor, number]>,

repeating?: boolean

}

角度渐变。

- center:为角度渐变的中心点,即相对于当前组件左上角的坐标。

- start:角度渐变的起点。

默认值:0

- end:角度渐变的终点。

默认值:0

- rotation: 角度渐变的旋转角度。

默认值:0

- colors: 为渐变的颜色描述。

- repeating: 为渐变的颜色重复着色。

默认值:false

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

说明:

设置为小于0的值时,按值为0处理。设置为大于360的值时,按值为360处理。当start、end、rotation的数据类型为string,值为"90"或"90%",与90效果一致。

radialGradient

{

center: Point,

radius: number | string,

colors: Array<[ResourceColor, number]>,

repeating?: boolean

}

径向渐变。

- center:径向渐变的中心点,即相对于当前组件左上角的坐标。

- radius:径向渐变的半径。

取值范围 [0,+∞)

说明:

设置为小于的0值时,按值为0处理。

- colors: 为渐变的颜色描述。

- repeating: 为渐变的颜色重复着色。

默认值:false

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

说明

colors参数的约束:

ResourceColor表示填充的颜色,number表示指定颜色所处的位置,取值范围为[0,1.0],0表示需要设置渐变色的容器的开始处,1.0表示容器的结尾处。想要实现多个颜色渐变效果时,多个数组中number参数建议递增设置,如后一个数组number参数比前一个数组number小的话,按照等于前一个数组number的值处理。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct ColorGradientExample {
  5. build() {
  6. Column({ space: 5 }) {
  7. Text('linearGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
  8. Row()
  9. .width('90%')
  10. .height(50)
  11. .linearGradient({
  12. angle: 90,
  13. colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 1.0]]
  14. })
  15. Text('linearGradient Repeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
  16. Row()
  17. .width('90%')
  18. .height(50)
  19. .linearGradient({
  20. direction: GradientDirection.Left, // 渐变方向
  21. repeating: true, // 渐变颜色是否重复
  22. colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 0.5]] // 数组末尾元素占比小于1时满足重复着色效果
  23. })
  24. }
  25. .width('100%')
  26. .padding({ top: 5 })
  27. }
  28. }

  1. @Entry
  2. @Component
  3. struct ColorGradientExample {
  4. build() {
  5. Column({ space: 5 }) {
  6. Text('sweepGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
  7. Row()
  8. .width(100)
  9. .height(100)
  10. .sweepGradient({
  11. center: [50, 50],
  12. start: 0,
  13. end: 359,
  14. colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 1.0]]
  15. })
  16. Text('sweepGradient Reapeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
  17. Row()
  18. .width(100)
  19. .height(100)
  20. .sweepGradient({
  21. center: [50, 50],
  22. start: 0,
  23. end: 359,
  24. rotation: 45, // 旋转角度
  25. repeating: true, // 渐变颜色是否重复
  26. colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 0.5]] // 数组末尾元素占比小于1时满足重复着色效果
  27. })
  28. }
  29. .width('100%')
  30. .padding({ top: 5 })
  31. }
  32. }

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct ColorGradientExample {
  5. build() {
  6. Column({ space: 5 }) {
  7. Text('radialGradient').fontSize(12).width('90%').fontColor(0xCCCCCC)
  8. Row()
  9. .width(100)
  10. .height(100)
  11. .radialGradient({
  12. center: [50, 50],
  13. radius: 60,
  14. colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 1.0]]
  15. })
  16. Text('radialGradient Repeat').fontSize(12).width('90%').fontColor(0xCCCCCC)
  17. Row()
  18. .width(100)
  19. .height(100)
  20. .radialGradient({
  21. center: [50, 50],
  22. radius: 60,
  23. repeating: true,
  24. colors: [[0xff0000, 0.0], [0x0000ff, 0.3], [0xffff00, 0.5]] // 数组末尾元素占比小于1时满足重复着色效果
  25. })
  26. }
  27. .width('100%')
  28. .padding({ top: 5 })
  29. }
  30. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号