1. 概述
在鸿蒙ArkUI中，颜色值是UI设计的基础元素之一。ArkUI支持多种颜色表示方式，包括关键字颜色、RGB/RGBA、十六进制等。本文将详细介绍这些颜色值的使用方法，特别是透明度的设置技巧。
2. 颜色值的基本表示方法
2.1 关键字颜色
ArkUI支持常见的CSS颜色关键字：
// 在ArkUI组件中使用
Text('红色文本')
.fontColor(Color.Red) // 使用Color枚举
.fontColor('red') // 或直接使用字符串
// 常用颜色关键字
'red', 'blue', 'green', 'black', 'white',
'gray', 'yellow', 'orange', 'purple', 'pink'
2.2 RGB颜色表示
RGB颜色通过红、绿、蓝三原色的混合来定义颜色：
基本RGB（不透明）
// 格式：rgb(红, 绿, 蓝)
// 每个参数取值范围：0-255
Text('RGB颜色示例')
.fontColor('rgb(255, 0, 0)') // 红色
.backgroundColor('rgb(0, 255, 0)') // 绿色背景
.fontColor('rgb(0, 0, 255)') // 蓝色
RGBA（带透明度）
// 格式：rgba(红, 绿, 蓝, 透明度)
// 透明度alpha取值范围：0.0-1.0
Text('RGBA带透明度')
.fontColor('rgba(255, 0, 0, 0.5)') // 半透明红色
.backgroundColor('rgba(0, 255, 0, 0.3)') // 30%不透明度绿色背景
2.3 十六进制颜色表示
6位十六进制（不透明）
// 格式：#RRGGBB
// RR: 红色分量（00-FF）
// GG: 绿色分量（00-FF）
// BB: 蓝色分量（00-FF）
Text('十六进制颜色')
.fontColor('#FF0000') // 红色
.fontColor('#00FF00') // 绿色
.fontColor('#0000FF') // 蓝色
.fontColor('#FFA500') // 橙色
8位十六进制（带透明度）
// 格式：#AARRGGBB 或 #ARGB
// AA: 透明度分量（00-FF）
// 00表示完全透明，FF表示完全不透明
Text('带透明度的十六进制颜色')
.fontColor('#80FF0000') // 50%透明度的红色
.fontColor('#4000FF00') // 25%透明度的绿色
.backgroundColor('#200000FF') // 12.5%透明度的蓝色背景
// 简写格式（4位）#ARGB
// 会被扩展为#AARRGGBB
Text('简写格式')
.fontColor('#8F00') // 相当于#8800FF00
3. 透明度设置的多种方式
3.1 使用RGBA的Alpha通道
// 最常用的透明度设置方式
@Component
struct TransparencyExample {
build() {
Column() {
// 不同透明度级别
Text('100% 不透明').fontColor('rgba(255, 0, 0, 1.0)')
Text('75% 不透明').fontColor('rgba(255, 0, 0, 0.75)')
Text('50% 不透明').fontColor('rgba(255, 0, 0, 0.5)')
Text('25% 不透明').fontColor('rgba(255, 0, 0, 0.25)')
Text('完全透明').fontColor('rgba(255, 0, 0, 0.0)')
}
}
}
3.2 使用8位十六进制
// 透明度计算：0x00-0xFF 对应 0%-100%
// 透明度百分比 = (AA / 255) * 100%
@Component
struct HexTransparencyExample {
build() {
Column() {
// 十六进制透明度示例
Text('FF = 100%').fontColor('#FFFF0000')
Text('BF = 75%').fontColor('#BFFF0000')
Text('80 = 50%').fontColor('#80FF0000')
Text('40 = 25%').fontColor('#40FF0000')
Text('00 = 0%').fontColor('#00FF0000')
}
}
}
3.3 使用Color类的静态方法
// ArkUI提供了Color类的静态方法
@Component
struct ColorClassExample {
build() {
Column() {
// 使用Color类创建带透明度的颜色
Text('Color.Red透明度')
.fontColor(Color.Red)
.opacity(0.5) // 设置整个组件的透明度
// Color.argb方法
Text('Color.argb示例')
.fontColor(Color.argb(128, 255, 0, 0)) // 50%透明红色
// Color.rgb方法
Text('Color.rgb示例')
.fontColor(Color.rgb(255, 0, 0))
}
}
}
4. 颜色资源的定义与使用
4.1 在资源文件中定义颜色
在 resources/base/element/color.json 中：
{
"color": [
{
"name": "primary_color",
"value": "#FF6200"
},
{
"name": "primary_color_transparent",
"value": "#806200"
},
{
"name": "text_color",
"value": "rgba(0, 0, 0, 0.87)"
},
{
"name": "background_transparent",
"value": "rgba(255, 255, 255, 0.8)"
}
]
}
4.2 在ArkUI中使用颜色资源
@Component
struct ColorResourceExample {
build() {
Column() {
Text('使用颜色资源')
.fontColor($r('app.color.primary_color'))
.backgroundColor($r('app.color.background_transparent'))
Text('带透明度的资源颜色')
.fontColor($r('app.color.primary_color_transparent'))
}
.padding(20)
}
}
5. 实际应用示例
5.1 渐变背景与透明度
@Component
struct GradientExample {
@State opacityValue: number = 0.5
build() {
Column() {
// 线性渐变背景
Text('渐变背景示例')
.fontSize(20)
.fontColor('#FFFFFF')
.width('100%')
.height(100)
.backgroundImage(
`linear-gradient(
rgba(255, 0, 0, ${this.opacityValue}),
rgba(0, 0, 255, ${this.opacityValue})
)`
)
// 动态调整透明度
Slider({
value: this.opacityValue,
min: 0,
max: 1,
step: 0.1
})
.onChange((value: number) => {
this.opacityValue = value
})
.margin({ top: 20 })
}
.padding(20)
}
}
5.2 卡片阴影与背景透明度
@Component
struct CardExample {
build() {
Column() {
// 半透明卡片
Column() {
Text('透明卡片标题')
.fontSize(18)
.fontColor('#333333')
Text('卡片内容描述')
.fontSize(14)
.fontColor('rgba(51, 51, 51, 0.7)')
.margin({ top: 10 })
}
.padding(20)
.width('90%')
.backgroundColor('rgba(255, 255, 255, 0.9)') // 90%不透明度白色
.borderRadius(10)
.shadow({
radius: 10,
color: 'rgba(0, 0, 0, 0.1)', // 10%不透明度黑色阴影
offsetX: 0,
offsetY: 2
})
}
.width('100%')
.height('100%')
.backgroundImage('/common/background.png')
}
}
5.3 主题色与透明度结合
// 定义主题
const Theme = {
primary: '#FF6200',
primaryLight: 'rgba(255, 98, 0, 0.2)',
primarySemi: 'rgba(255, 98, 0, 0.6)',
textPrimary: 'rgba(0, 0, 0, 0.87)',
textSecondary: 'rgba(0, 0, 0, 0.6)'
}
@Component
struct ThemeExample {
build() {
Column({ space: 20 }) {
// 主要按钮
Button('主要按钮', { type: ButtonType.Capsule })
.backgroundColor(Theme.primary)
.fontColor('#FFFFFF')
.width('80%')
// 次要按钮（带透明度）
Button('次要按钮', { type: ButtonType.Capsule })
.backgroundColor(Theme.primaryLight)
.fontColor(Theme.primary)
.width('80%')
// 文本示例
Text('主要文本')
.fontColor(Theme.textPrimary)
.fontSize(16)
Text('次要文本')
.fontColor(Theme.textSecondary)
.fontSize(14)
}
.padding(20)
.width('100%')
}
}
6. 最佳实践与注意事项
6.1 性能优化建议
// 1. 复用颜色常量
const Colors = {
transparent: 'rgba(0, 0, 0, 0)',
white: '#FFFFFF',
black: '#000000',
gray100: 'rgba(0, 0, 0, 0.02)',
gray200: 'rgba(0, 0, 0, 0.05)',
// ... 更多颜色
}
// 2. 避免频繁创建颜色对象
@Component
struct OptimizedExample {
// 在build外定义颜色
private readonly highlightColor = 'rgba(255, 98, 0, 0.1)'
build() {
Column() {
Text('优化示例')
.backgroundColor(this.highlightColor) // 复用颜色
}
}
}
6.2 可访问性考虑
@Component
struct AccessibilityExample {
build() {
Column() {
// 确保文本与背景有足够的对比度
Text('高对比度文本')
.fontColor('rgba(0, 0, 0, 0.87)') // 87%不透明度黑色
.backgroundColor('rgba(255, 255, 255, 0.95)') // 95%不透明度白色
// 半透明背景上的文字
Text('半透明背景文字')
.fontColor('#000000')
.backgroundColor('rgba(255, 255, 255, 0.7)') // 足够的对比度
.padding(10)
}
}
}
6.3 响应式设计中的颜色使用
@Component
struct ResponsiveExample {
@StorageLink('darkMode') isDarkMode: boolean = false
build() {
Column() {
Text('响应式颜色示例')
.fontColor(this.isDarkMode ?
'rgba(255, 255, 255, 0.87)' : // 暗色模式
'rgba(0, 0, 0, 0.87)' // 亮色模式
)
.backgroundColor(this.isDarkMode ?
'rgba(0, 0, 0, 0.8)' : // 暗色背景
'rgba(255, 255, 255, 0.9)' // 亮色背景
)
}
}
}
7. 调试技巧
7.1 颜色调试组件
@Component
struct ColorDebugger {
@State colors: Array<{ name: string, value: string }> = [
{ name: 'Primary', value: '#FF6200' },
{ name: 'Primary 50%', value: '#80FF6200' },
{ name: 'Gray', value: 'rgba(0, 0, 0, 0.12)' },
{ name: 'White Transparent', value: 'rgba(255, 255, 255, 0.8)' }
]
build() {
Column({ space: 10 }) {
ForEach(this.colors, (color) => {
Row({ space: 10 }) {
// 颜色预览
Rect()
.width(40)
.height(40)
.fill(color.value)
// 颜色信息
Column() {
Text(color.name)
.fontSize(14)
Text(color.value)
.fontSize(12)
.fontColor('#666666')
}
}
.width('100%')
.padding(10)
.border({ width: 1, color: 'rgba(0, 0, 0, 0.1)' })
})
}
.padding(20)
}
}
总结
ArkUI提供了丰富灵活的颜色表示方式，开发者可以根据具体场景选择合适的方法：
-
简单场景：使用关键字或6位十六进制
-
需要透明度：优先使用RGBA格式，直观易读
-
性能敏感：预定义颜色常量，避免重复创建
-
设计系统：使用资源文件管理颜色，便于维护和主题切换
-
可访问性：确保颜色对比度符合WCAG标准
通过合理使用颜色和透明度，可以创建出既美观又具有良好用户体验的鸿蒙应用界面。
登录
通过快照的“保留器链”（Retainers）功能，梳理出完整的泄漏链路（注意：链路方向并非“外部→内部”，而是外部引用锚定内部对象后，内部闭环加固引用）：