在移动应用开发中,常遇到这样的典型场景:同一套图标素材需要根据用户主题、交互状态(如点击/禁用)或场景模式(如深色/浅色模式)呈现不同颜色。传统方案中,开发者往往通过准备多套资源文件或使用Canvas绘制来实现颜色变化,但这会导致安装包体积膨胀(资源冗余)和渲染性能损耗。
通过Image组件的colorFilter,只需单份原始图片配合颜色矩阵,即可实现运行时动态变色:
// 注入颜色变换矩阵 Image($r('app.media.icon_toast_warning')) .colorFilter( [1, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0])
但该方案面临一个问题:如何将人类可读的十六进制颜色(如#4f0f48db)转换为colorFilter所需的4×5颜色矩阵?
在计算机图形学中,每个像素由四个维度的数据构成,可表示为四维向量:

颜色矩阵本质是执行以下运算的线性变换器:

颜色矩阵M的参数语义:
运算时需将值归一化至0.0–1.0范围(1.0对应255)。
矩阵结构计算:
// 输出R通道的计算公式 R' = m00*R + m01*G + m02*B + m03*A + m04 // 输出G通道的计算公式 G' = m10*R + m11*G + m12*B + m13*A + m14 // 输出B通道同理 // Alpha通道独立处理 A' = m30*R + m31*G + m32*B + m33*A + m34
纯色替换矩阵:将图像转换为目标色(如#2196F3)需满足:

对应矩阵:
[ 0, 0, 0, 0, TargetR, 0, 0, 0, 0, TargetG, 0, 0, 0, 0, TargetB, 0, 0, 0, 1, 0 ]
关键问题在于如何将目标色的十六进制值转换为TargetR、TargetG、TargetB。得到颜色矩阵后,即可通过Image组件的colorFilter属性实现颜色滤镜效果。
实现图片动态变色,可使用Image的colorFilter。其参数所需的颜色矩阵,可通过以下封装方法将十六进制颜色值转换得到:
class ColorUtils { /** * 将十六进制颜色值转换为4x5颜色矩阵 * @param hexColor 十六进制颜色字符串,支持格式:#RRGGBB, #AARRGGBB * @returns 4x5颜色矩阵数组 (20个元素的number数组) */ static hexToColorMatrix(hexColor: string): number[] { // 验证输入格式 if (!/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/.test(hexColor)) { throw new Error('Invalid hex color format. Expected #RRGGBB or #AARRGGBB'); } // 提取颜色通道值 let rgba = hexColor.substring(1); if (rgba.length === 6) { rgba = 'FF' + rgba; // 添加默认Alpha通道 } // 解析ARGB通道值(含归一化处理) const alpha = parseInt(rgba.substring(0, 2), 16) / 255; const red = parseInt(rgba.substring(2, 4), 16) / 255; const green = parseInt(rgba.substring(4, 6), 16) / 255; const blue = parseInt(rgba.substring(6, 8), 16) / 255; /** * 构造纯色替换矩阵: * [0, 0, 0, 0, red, → 输出R通道 = 0*R + 0*G + 0*B + 0*A + 目标R * 0, 0, 0, 0, green, → 输出G通道 = 0*R + 0*G + 0*B + 0*A + 目标G * 0, 0, 0, 0, blue, → 输出B通道 = 0*R + 0*G + 0*B + 0*A + 目标B * 0, 0, 0, alpha, 0] → 输出A通道 = 0*R + 0*G + 0*B + alpha*A + 0 */ return [ 0, 0, 0, 0, red, 0, 0, 0, 0, green, 0, 0, 0, 0, blue, 0, 0, 0, alpha, 0 ]; } } @Entry @Component struct Example { // 图片资源 @State imageRes: Resource = $r('app.media.ic_pause'); // 运行时需替换为实际的图片资源 build() { Column() { // 未使用 Image(this.imageRes) .width(200) .height(200) .margin(16); // 使用colorFilter添加滤镜 Image(this.imageRes) .width(200) .height(200) .colorFilter(ColorUtils.hexToColorMatrix('#66666666')); }.justifyContent(FlexAlign.Center).width('100%').height('100%') } }