一、引言

ArkTS 渐变分为线性渐变linearGradient、径向渐变radialGradient、角度渐变sweepGradient。。

二、线性渐变 linearGradient

2.1 功能定义

线性渐变是沿着一条直线进行颜色过渡的渐变效果,通过linearGradient()属性配置,在组件内生成沿着指定方向的连续色彩过渡。

2.2 参数说明

表格

参数说明
angle渐变起始角度,0 点顺时针旋转为正向角度,默认值 180;设置 angle 后,direction 参数失效
direction枚举GradientDirection渐变方向,包含 Left、Top、Right、Bottom、LeftTop、LeftBottom、RightTop、RightBottom,代表预设渐变走向
colors颜色断点数组,格式[[颜色, 位置比例],...],位置取值 0~1,代表该颜色在渐变轴上的相对位置
repeating可选布尔值,是否开启重复着色

规则:angle与direction二选一,配置角度优先于预设方向。
angle各渲染角度方向如图:
在这里插入图片描述其中:
(<=>)两侧等价
angle:0<=>direction:GradientDirection.Top //从下往上渲染
angle:180<=>direction:GradientDirection. Bottom //从上往下渲染
angle:90<=>direction:GradientDirection.Right //从左往右渲染
angle:0<=>direction:GradientDirection.Left //从右往左渲染
…

2.3 示例代码


@Entry
@Component
struct Index {
  build() {
    Column({ space: 10 }) {
      Text('线性')
        .width(100).height(50)
        .linearGradient({
          direction: GradientDirection.Right,
          colors: [['red', 0.1], ['#fc0', 0.8]]``
        })
    }.padding(20)
  }
}

该示例实现从左向右的线性渐变,红色在渐变轴 10% 位置,黄色在 80% 位置。
效果如下:
在这里插入图片描述

三、径向渐变 radialGradient

3.1 功能定义

径向渐变是以一个中心点向外扩散、圆形放射状的颜色渐变,由radialGradient()属性实现,适合光斑、圆点光晕等效果。

3.2 参数说明

表格

参数说明
center渐变中心点坐标,[x,y],坐标相对于组件左上角
radius渐变扩散半径
colors颜色断点数组,和线性渐变格式一致
repeating可选布尔值,是否重复着色

3.3 示例代码

@Entry
@Component
struct Index {
  build() {
    Column({ space: 10 }) {
      Text('径向')
        .width(100).height(50)
        .radialGradient({
          center: [40, 0],
          radius: 40,
          colors: [
            [Color.Red, 0],
            [Color.Blue, 1]
          ]
        })
    }.padding(20)
  }

示例中心点在[40,0],半径 40,从红色平滑过渡到完全透明白色,实现光晕效果。
效果图如下:
在这里插入图片描述

四、角度渐变 sweepGradient

4.1 功能定义

角度渐变沿着圆弧扇形方向进行色彩过渡,由sweepGradient()属性实现,适合色环、环形进度、饼图等场景,是三类渐变中角度逻辑最复杂的渐变。

4.2 角度参数

角度渐变包含三个角度相关参数:start、end、rotation,三者作用完全不同,所有角度正向规则均为顺时针:

  1. start:渐变起始角度
    基准:0°代表中心点水平向右(X 轴正方向);start:90代表从正上方开始绘制渐变。
    2. end:渐变结束角度
    start和end共同决定扇形的开合大小:
    start:0, end:180:只绘制半圆
    start:0, end:360:绘制完整一圈色环 总结:start、end控制扇形范围大小
  2. rotation:渐变整体旋转角度
    不改变start与end的差值(扇形开口大小不变),将整套渐变图案整体顺时针旋转,只改变渐变朝向。

注意:start/end 管扇形多大;rotation 管整个渐变转到哪个朝向

4.3 代码示例对比

// 版本1:默认,从右侧0°开始,铺满360度完整一圈
.sweepGradient({
  center:[50,50], start:0, end:360, rotation:0,
  colors:[[0xff0000,0],[0x00ff00,1]]
})

// 版本2:依然是完整360°一圈,但是整套渐变顺时针旋转45°
.sweepGradient({
  center:[50,50], start:0, end:360, rotation:45,
  colors:[[0xff0000,0],[0x00ff00,1]]
})

两个示例扇形范围都是 360°,区别仅在于第二个色环整体顺时针转动 45°。
如图:
在这里插入图片描述

五、三类渐变对比总结

表格

渐变类型属性名渐变形态参数典型场景
线性渐变linearGradient沿直线过渡angle / direction、colors渐变按钮、长条背景
径向渐变radialGradient从中心点向外圆形放射center、radius、colors光斑、光晕、圆点
角度渐变sweepGradient沿圆弧扇形start、end、rotation色环、环形进度、饼图

六、animation 动画属性

介绍:

.animation() 可以绑定任意组件,只要组件属性随 @State 变化,就能产生过渡动画。
1..animation() 是组件通用属性,Circle、Text、Image、Button、Row、Column 等所有组件都可以挂载使用。
2.动画生效核心条件:组件的样式属性(scale、rotate、opacity、width、height、位置、sweepGradient 的 rotation 等)由@State装饰的变量控制;当 @State 变量发生改变时,animation 自动触发平滑过渡动画。
3.示例场景:
-Text 绑定 opacity + animation → 文字淡入淡出动画
-Circle 中 sweepGradient 的 rotation + animation → 锥形渐变旋转动画
-Button 修改 width + animation → 按钮宽度平滑变化动画组件 scale 缩放 + animation → 缩放动画
表格

参数名类型默认值说明
durationnumber1000动画时长,单位 ms;0 代表无过渡、直接跳变Huawei Dev…
delaynumber0动画延迟多久后开始播放,单位 ms
curveCurve / stringCurve.Linear动画插值曲线,控制快慢节奏常用:Curve.Ease / Curve.EaseIn / Curve.EaseOut / Curve.EaseInOut
iterationsnumber1播放次数;-1 = 无限循环播放
代码:
import curves from '@ohos.curves'
@Entry
@Component
struct Page {
  @State message: string = 'Hello World';
    build() {
      Column() {
        Text('文本')
          .width(50)
          .height(50)
          .backgroundColor(Color.Pink)
          .stateStyles({
            pressed: {
              .width(200)
            }
          })
          .animation({
            duration: 2000,
            // 速度曲线
            curve:curves.springMotion(),
            delay: 1000,
            iterations: -1
          })
      }
      .padding(20)
    }
}

七、多态样式 stateStyles

1. 作用

多态样式,用来快速设置组件不同状态下的样式,无需手动写 @State 去判断状态
支持的内置状态:
Pressed:按下状态
Hover:鼠标悬浮(PC / 平板)
Focused:获取焦点
Normal:默认常态
disabled:禁用态
clicked:点击态
selected:选中态
hovered:悬浮态
用法:

Button("按钮")
  .stateStyles({
    Normal: {
      backgroundColor: '#007DFF'
    },
    Pressed: {
      backgroundColor: '#005ECC',
      scale: 0.95
    }
  })

八、shadow 阴影

1. 作用

给组件添加阴影效果,增强立体感、层次感,支持外部阴影。

2. 属性:.shadow()

参数以及用法:

shadow({
  radius: number,      // 阴影模糊半径,越大越虚
  color: ResourceColor,// 阴影颜色
  offsetX: number,     // X方向偏移,正数向右,负数向左
  offsetY: number      // Y方向偏移,正数向下,负数向上
})

     Column() {
        Text("带阴影文字")
          .shadow({radius:8,color:'#33333366',offsetX:2,offsetY:2})
      }
      .padding(20)
      .backgroundColor(Color.Red)

效果图:
在这里插入图片描述
注意:阴影是组件外渲染效果,不会挤占布局空间,不会影响组件宽高

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐