怎么在HTML中通过picture标签实现暗黑模式图片切换

陌静同学_6714

陌静同学_6714

2026-08-24

406人浏览

原创

标签不支持暗黑模式动态切换,仅通过 media 属性静态匹配 prefers-color-scheme;需配合 css 媒体查询与 source 的 media 属性实现首次加载主题适配,但切换主题后需 js 监听 matchmedia 手动更新 的 src。

怎么在html中通过picture标签实现暗黑模式图片切换

picture 标签本身不感知暗黑模式

直接用 <picture></picture> 无法自动响应系统暗黑模式切换,它只是根据 media 属性做静态媒体查询匹配,不会监听 prefers-color-scheme 的动态变化。必须配合 CSS 媒体查询 + source 的 media 属性才能实现「首次加载时按当前主题选图」,但页面主题切换后不会重载图片。

用 media="(prefers-color-scheme: dark)" 指定暗黑图源

这是最常用、兼容性足够(Chrome 82+、Firefox 67+、Safari 14+)的做法。关键在 source 的 media 属性值要写对:

<picture><source srcset="logo-dark.png" media="(prefers-color-scheme: dark)"><source srcset="logo-light.png" media="(prefers-color-scheme: light)">
  @@##@@
</source></source></picture>

注意几点:

  • media 值必须是完整字符串 "(prefers-color-scheme: dark)",不能漏括号或空格
  • 多个 source 元素顺序重要:浏览器从上到下匹配第一个满足 media 的,所以建议把 dark 放前面(避免某些旧浏览器忽略 prefers-color-scheme 后 fallback 到 light)
  • <img src="logo-light.png" alt="Logo"> 是必需的 fallback,且其 src 应与最后一个 source 一致,否则无匹配时可能加载错误图片
  • 不支持 Safari 13 及更早版本——它们会忽略所有 media 并直接使用 <img>

想支持运行时主题切换?得靠 JavaScript 补位

如果用户手动点击切换主题(比如页面上有 toggle 按钮),<picture></picture> 不会自动更新。此时需要监听 matchMedia 并手动替换 <img> 的 src:

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载
const img = document.querySelector("picture img");
const darkModeQuery = window.matchMedia("(prefers-color-scheme: dark)");

function updateImage() {
  img.src = darkModeQuery.matches ? "logo-dark.png" : "logo-light.png";
}

darkModeQuery.addEventListener("change", updateImage);
updateImage(); // 初始化

这种方案绕过了 <picture></picture> 的语义,但能保证实时响应。适合主题由 JS 控制、而非纯系统偏好驱动的场景。

别忘了响应式 + 暗黑模式的叠加写法

实际项目中往往既要适配屏幕尺寸,又要区分明暗主题。可以把多个媒体条件用 and 连接:

<source srcset="hero-dark@2x.jpg" media="(prefers-color-scheme: dark) and (min-width: 768px)"><source srcset="hero-light@2x.jpg" media="(prefers-color-scheme: light) and (min-width: 768px)"><source srcset="hero-dark-mobile.jpg" media="(prefers-color-scheme: dark) and (max-width: 767px)"></source></source></source>

注意:

  • 每个 source 只能有一个 media,不能拆成两个属性
  • 条件之间用空格分隔,and 必须小写且前后有空格
  • 复杂条件容易写错,建议用浏览器 DevTools 的 Rendering 面板临时模拟 prefers-color-scheme 测试

真正麻烦的是当设计稿要求「暗黑模式下还要保留部分亮色元素」——这时候图片本身可能就得重新出稿,而不是靠前端切换解决。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

6595

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3672

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

3350

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

3359

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

5019

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

3301

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

3109

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2728

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2828

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 228人学习