文档开发者中心
我的

Flutter 鸿蒙 ColorFiltered 颜色滤镜:一键灰度/复古/变色

浏览6.5W+发布于2026-06-30 15:44河南
本文章最后由 在人间耕耘 于 2026-07-05 00:16 编辑

在鸿蒙项目里用 ColorFiltered 做全局灰度

之前写项目的时候碰到一个需求——App 里要加一个"关怀模式"开关,打开后整个界面变灰度。一开始想着是不是要每个页面单独处理,后来发现 Flutter 的 ColorFiltered 组件,包在最外层就搞定全局灰度。

这篇文章就记一下我是怎么用的。虽然 ColorFiltered 本身是 Flutter 通用组件,但在鸿蒙设备上跑了一圈,有些表现还挺有意思的。

灰度模式的需求

事情是这样的——有个用户反馈,说 App 的界面太花了,上了年纪看着眼睛累。我一查,灰度模式其实挺常见的,很多 App 在清明节也把页面变成灰色。

我的项目是基于鸿蒙 Next 的 Flutter 应用,所以一切都要在鸿蒙真机上验证。我最关心的是两件事:

  1. 灰度效果能不能覆盖整个 App?包括导航栏、图片、按钮
  2. 性能有没有问题?鸿蒙的 Flutter 引擎在 GPU 渲染上和 Android 不太一样

后来两个问题都搞定了,往下看。

ColorFilter + ColorFiltered 基础

ColorFilter 是变换的定义,ColorFiltered 是包装组件。

收起
自动换行
深色代码主题
复制
ColorFiltered(
  colorFilter: ColorFilter.mode(Colors.red, BlendMode.srcOver),
  child: YourWidget(),
)

ColorFiltered 会把 child 渲染到离屏缓冲区,然后逐像素应用 colorFilter。这就是说它可以包装任何组件——图片、文字、甚至整个 MaterialApp。

我一开始还纳闷,那如果图片很多,是不是每张图都要套一个。后来试了一下发现直接在 MaterialApp 外面包一层就行,所有子页面自动继承滤镜效果。

两种核心模式

ColorFilter.mode

用颜色和混合模式来染色。这个比较简单直接:

收起
自动换行
深色代码主题
复制
// 泛红色效果——做节日氛围用
ColorFilter.mode(
  Colors.red.withValues(alpha: 0.3),
  BlendMode.srcOver,
)

// 只保留蓝色通道——冷色调风格
ColorFilter.mode(
  Colors.blue,
  BlendMode.srcIn,
)

// 正片叠底暗化——适合深色模式降亮
ColorFilter.mode(
  Colors.purple.withValues(alpha: 0.3),
  BlendMode.multiply,
)

BlendMode 枚举值挺多的,实际常用的就 srcOver、srcIn、multiply。我在做灰度模式之前,先用 mode 的 multiply 测试了一下效果能不能正常渲染——结果在鸿蒙模拟器上跑没问题,真机也 OK。

ColorFilter.matrix

这是最强大但写法也最吓人的方式。通过一个 5x4 的矩阵(20 个 double)精确控制 RGBA 通道:

收起
自动换行
深色代码主题
复制
ColorFilter.matrix(<double>[
  R_scale, R_red, R_green, R_blue, R_offset,
  G_scale, G_red, G_green, G_blue, G_offset,
  B_scale, B_red, B_green, B_blue, B_offset,
  A_scale, A_red, A_green, A_blue, A_offset,
])

每个通道的计算:输出 = 输入R * m[0] + 输入G * m[1] + 输入B * m[2] + 输入A * m[3] + m[4]

看不懂矩阵正常,我也不想记——直接用现成的就行。

灰度矩阵(做关怀模式的核心):

收起
自动换行
深色代码主题
复制
const ColorFilter.matrix(<double>[
  0.2126, 0.7152, 0.0722, 0, 0,
  0.2126, 0.7152, 0.0722, 0, 0,
  0.2126, 0.7152, 0.0722, 0, 0,
  0, 0, 0, 1, 0,
])

这 20 个数的作用:人眼对绿色最敏感(0.7152)、红色次之(0.2126)、蓝色最低(0.0722),按这个比例混合三个通道就得到了灰度。

复古矩阵(棕褐色调):

收起
自动换行
深色代码主题
复制
const ColorFilter.matrix(<double>[
  0.393, 0.769, 0.189, 0, 0,
  0.349, 0.686, 0.168, 0, 0,
  0.272, 0.534, 0.131, 0, 0,
  0, 0, 0, 1, 0,
])

反色矩阵:

收起
自动换行
深色代码主题
复制
const ColorFilter.matrix(<double>[
  -1, 0, 0, 0, 255,
  0, -1, 0, 0, 255,
  0, 0, -1, 0, 255,
  0, 0, 0, 1, 0,
])

矩阵配出来反色效果用的,我项目里没用到,但试了一下确实挺酷的。

实际应用场景

全局灰度(关怀模式)

我最核心的需求,加一个开关控制全局灰度。做法很简单——把 ColorFiltered 包在 MaterialApp 外层:

收起
自动换行
深色代码主题
复制
class MyApp extends StatelessWidget {
  const MyApp({super.key, required this.isGrayMode});

  final bool isGrayMode;

  @override
  Widget build(BuildContext context) {
    return ColorFiltered(
      colorFilter: isGrayMode
          ? const ColorFilter.matrix(<double>[
              0.2126, 0.7152, 0.0722, 0, 0,
              0.2126, 0.7152, 0.0722, 0, 0,
              0.2126, 0.7152, 0.0722, 0, 0,
              0, 0, 0, 1, 0,
            ])
          : const ColorFilter.mode(Colors.transparent, BlendMode.dst),
      child: MaterialApp(
        // ...
      ),
    );
  }
}

灰度模式切成 const,每次 rebuild 不会重建对象,这个后面细说。关闭灰度时用 BlendMode.dst 而不是 null,性能更好。

我在鸿蒙真机上跑了一下灰度模式——打开后整个界面变黑白,图片、按钮、导航栏无一幸免。有点意思的是,连应用市场评分跳转的那个弹窗页面也是灰色的(那个页面是系统页面,不是 Flutter 页面),说明 ColorFiltered 只影响它包裹的 Flutter 组件,不影响系统级 UI。

图片图标一键换色

准备多套颜色的图标资源太麻烦了,尤其是不同主题色下要换色。用 ColorFiltered 配合 BlendMode.srcAtop 搞定:

收起
自动换行
深色代码主题
复制
ColorFiltered(
  colorFilter: ColorFilter.mode(
    selectedColor.withValues(alpha: 0.5),
    BlendMode.srcAtop,
  ),
  child: Image.asset('assets/icon.png'),
)

这样一张白色图标底图,通过 selectedColor 就能染成任意颜色。比准备 10 套颜色图标省事多了。

不过这个方案有个坑——图片本身必须是透明底的,如果底图有白色背景,染色效果就不对了。

页面入场淡入效果

收起
自动换行
深色代码主题
复制
AnimatedOpacity(
  opacity: _visible ? 1.0 : 0.0,
  duration: const Duration(milliseconds: 500),
  child: ColorFiltered(
    colorFilter: ColorFilter.mode(
      Colors.white.withValues(alpha: _visible ? 0 : 0.5),
      BlendMode.srcOver,
    ),
    child: content,
  ),
)

这种场景我实际用得不多,但列表项入场时用一下效果还可以。

踩坑记录

灰度模式在鸿蒙模拟器上正常,真机上闪烁

第一次在鸿蒙真机上跑灰度模式,打开开关后界面闪了一下才变灰。排查发现是因为 isGrayMode 变了之后触发整个 MaterialApp 重建,灰度矩阵重新创建,中间有个过渡帧是原色的。

解决方法:把矩阵定义为 static const,避免重建:

收起
自动换行
深色代码主题
复制
// 好——可以复用,不重建
static const _grayFilter = ColorFilter.matrix([
  0.2126, 0.7152, 0.0722, 0, 0,
  0.2126, 0.7152, 0.0722, 0, 0,
  0.2126, 0.7152, 0.0722, 0, 0,
  0, 0, 0, 1, 0,
]);

// 保持常量的关闭态滤镜
static const _noFilter = ColorFilter.mode(Colors.transparent, BlendMode.dst);

改完后就不闪了,所以 const 的重要性在这里体现出来了。

BlendMode.dst 不应用滤镜

一开始我还想着用 null 来判断要不要关滤镜……折腾了一圈发现传 BlendMode.dst 就行:

收起
自动换行
深色代码主题
复制
ColorFilter.mode(Colors.transparent, BlendMode.dst)

BlendMode.dst 表示保留目标像素(也就是子组件原来的内容),不做任何混合。比 null 安全,不用每次判空。

只影响视觉,不影响布局

滤镜只改渲染颜色,不影响尺寸位置也不会挡点击。按钮变灰了照样能点。

但如果需求是灰度下不能操作,得配合 IgnorePointer:

收起
自动换行
深色代码主题
复制
IgnorePointer(
  ignoring: isGrayMode,
  child: ColorFiltered(
    colorFilter: isGrayMode ? _grayFilter : _noFilter,
    child: child,
  ),
)

矩阵写错直接白屏

ColorFilter.matrix 要 20 个 double 少一个多一个都不行……我第一次写数错了,少了个 0,App 直接白屏。这种错不报在编译期,build 时才抛,在鸿蒙 Flutter 上定位起来挺费劲的。建议先把矩阵抽成变量数清楚再放进去。

和 Clipping 的嵌套顺序

同时用圆角和滤镜时,ClipRRect 放外面,ColorFiltered 放里面:

收起
自动换行
深色代码主题
复制
ClipRRect(
  borderRadius: BorderRadius.circular(16),
  child: ColorFiltered(
    colorFilter: _grayFilter,
    child: image,
  ),
)

反过来圆角会被滤镜盖掉一部分,效果不对。

和 Opacity 的区别

Opacity 只管透明度,ColorFiltered 能控制每个颜色通道。简单淡入淡出用 Opacity 就够了,但要做"先变灰再淡出"这种复合效果就得两个一起上。

性能测试

在鸿蒙真机上做了一下性能测试:

场景 帧率 备注
无滤镜 60fps 基准
全局灰度(const 矩阵) 60fps 无感知
动态mode(非 const) 55-60fps 偶尔掉帧
多个 ColorFiltered 嵌套 50-55fps 可以接受,不建议滥用

结论:ColorFiltered 挂一个作为全局滤镜性能没影响。但别在列表项里每项都挂一个——每个 ColorFiltered 都要离屏渲染,多了扛不住。

我在列表页尝试过每项加滤镜,结果滑动掉帧比较明显。后来改用 ShaderMask 替代,性能好一些,但写法复杂多了。最后还是只在 MaterialApp 外面挂一层,需要的场景才打开。

验证环境

收起
自动换行
深色代码主题
复制
Flutter 3.27.4
Dart 3.6.2
DevEco Studio 5.0.3.400
HarmonyOS NEXT 5.0.0.29

写在最后

ColorFiltered 看着简单,全局灰度覆写就几行代码。不过坑也不少——const 忘了加会闪、矩阵数错了直接白屏、嵌套顺序不对效果出不来。一套下来也算把颜色滤镜摸透了。

对了,如果你在鸿蒙 Flutter 上试,建议先开开发者选项里的 GPU 渲染分析或者用 DevEco Studio 的 Profiler 看下开销,实测只挂一个滤镜基本不影响帧率。

收藏
0
回复
1
分享
全部评论
authorIcon
lorin
学习了
回复于2026-07-01 02:42广东
写评论
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。
发表
我要写文章
目录 收起
在鸿蒙项目里用 ColorFiltered 做全局灰度
灰度模式的需求
ColorFilter + ColorFiltered 基础
两种核心模式
ColorFilter.mode
ColorFilter.matrix
实际应用场景
全局灰度(关怀模式)
图片图标一键换色
页面入场淡入效果
踩坑记录
灰度模式在鸿蒙模拟器上正常,真机上闪烁
性能测试
验证环境
写在最后
了解社区公约,与您携手共创和谐专业的开发者社区。