直接写 brightness(0.7) 在暗黑模式下不生效,是因为它是静态值,浏览器无法响应 data-theme 变化;必须用 CSS 变量 var(--img-brightness) 并在 :root 和 [data-theme="dark"] 中分别定义以实现动态切换。

为什么直接写 brightness(0.7) 在暗黑模式下不生效
不是 CSS 解析失败,而是值没变。硬编码的 brightness(0.7) 是静态数值,浏览器不会因为 data-theme="dark" 切换就自动重算——它压根不知道这个变化。只有把亮度值抽成 CSS 变量,再靠选择器优先级覆盖,filter 才会响应更新。
必须用 var(--img-brightness),且在两个地方定义
变量只在一处定义(比如只写 :root { --img-brightness: 1; })是不够的。必须显式在暗色上下文中覆盖:
-
:root { --img-brightness: 1; }—— 亮色默认值 -
[data-theme="dark"] { --img-brightness: 0.85; }—— 暗色时提升优先级并赋新值 - 图片元素只需统一加 class,例如
,CSS 写.themed-img { filter: brightness(var(--img-brightness)); } - 别在
[data-theme="dark"] img里直接写filter: brightness(0.85),否则 JS 动态改data-theme时变量不触发重计算
brightness() 的取值不是越小越“适配暗色”
人眼在暗背景下对低亮度更敏感,brightness(0.5) 容易让细节塌陷、发灰发闷,反而显得“脏暗”。安全范围是:
- 亮色模式:保持
1(原始亮度) - 暗色模式:推荐
0.8–0.9,极少场景才用0.75 - 避免
brightness(0)或负值——规范不支持,部分浏览器静默忽略 - 若图片本身偏暗(如夜景图),暗色模式甚至可设为
1,再微调contrast(1.05)提层次,而非一味压暗
背景图、![]()
、SVG 图片不能共用同一套写法
三者受控方式不同,混用会导致失效:
-
和 SVG 中的:可直接受filter控制,但 SVG 需注意坐标系缩放可能影响滤镜渲染 - 背景图(
background-image):无法用background-filter(仅 Safari 16+ 实验性支持),必须给父容器加 class,再对容器整体加filter - 例如:
.bg-container { filter: brightness(var(--img-brightness)); },然后
真正容易被忽略的是:滤镜组合顺序会影响最终效果,比如 brightness(0.8) contrast(1.1) 和 contrast(1.1) brightness(0.8) 渲染结果并不完全等价;还有,移动端频繁使用多个滤镜(尤其 blur())会明显掉帧,暗黑模式下更要控制叠加数量。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











