鸿蒙:ArkTS 中三种颜色渐变样式,动画、阴影与多态样式知识点总结
一、引言
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,三者作用完全不同,所有角度正向规则均为顺时针:
start:渐变起始角度
基准:0°代表中心点水平向右(X 轴正方向);start:90代表从正上方开始绘制渐变。
2.end:渐变结束角度
start和end共同决定扇形的开合大小:
start:0, end:180:只绘制半圆
start:0, end:360:绘制完整一圈色环 总结:start、end控制扇形范围大小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 → 缩放动画
表格
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| duration | number | 1000 | 动画时长,单位 ms;0 代表无过渡、直接跳变Huawei Dev… |
| delay | number | 0 | 动画延迟多久后开始播放,单位 ms |
| curve | Curve / string | Curve.Linear | 动画插值曲线,控制快慢节奏常用:Curve.Ease / Curve.EaseIn / Curve.EaseOut / Curve.EaseInOut |
| iterations | number | 1 | 播放次数;-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)
效果图:

注意:阴影是组件外渲染效果,不会挤占布局空间,不会影响组件宽高
更多推荐
其中:



所有评论(0)