目录

Safari 27.3 测试版可以将开发者未提供深色主题的浅色网站也显示为深色。新功能 Adaptive Dark Mode 可由用户自行启用,开发者在依赖自动颜色转换前,需要测试自己的页面显示效果。

要点#

  • WebKit 于 2026 年 11 月 3 日宣布为 Safari 27.3 测试版推出 Adaptive Dark Mode。
  • 将操作系统外观设为深色后,在 Safari 的预览中选择“Try”即可启用。
  • Safari 会调整页面的颜色和对比度,大多数图片保持不变。
  • 开发者可以通过 color-scheme 声明支持自定义深色模式,但文档中用于排除自动转换的设置尚无法阻止测试版 1 的自动转换。

Safari 会更改哪些内容#

Adaptive Dark Mode 旨在解决即使将操作系统外观设为深色,浅色背景的网站仍保持明亮的问题。用户启用此功能后,Safari 可以将页面转换为深色配色。

Safari 会分析未通过 color-scheme 声明支持深色模式的页面。对于背景已为深色、文字为浅色的页面,不会更改其显示效果。对于浅色页面,则在保留色相的同时反转明度,并调整对比度以确保文字易于阅读。

大多数图片会保持原样。部分标志和图标在深色背景下难以辨认时,颜色会被调整。因此,测试时也需要检查图片和品牌视觉效果。并非所有素材都会保持原样显示。

如何试用#

使用 Safari 27.3 测试版,并将操作系统外观设为深色。打开一个背景为浅色、未声明支持自定义深色模式的网站。

Safari 会显示 Adaptive Dark Mode 的预览。选择“Try”即可启用。公告介绍了这一启用流程,但其他操作方式及可用情况需要在已安装的测试版中确认。

首次测试适合选用包含文字、链接、表单控件和标志的页面。检查转换后是否仍易于阅读,以及重要的视觉区别是否保留,例如已选中和未选中控件之间的差异。

声明自定义深色主题#

自动转换对用户很方便,但希望自行管理颜色的开发者需要提供深色主题并声明支持。Safari 不会更改通过 color-scheme 声明支持深色模式的网站颜色。

对于同时支持两种外观的页面,在 HTML 文档的 head 中添加以下声明。

snippet.txt
<meta name="color-scheme" content="light dark">

仅有这一声明并不会创建深色配色。实际的背景色和文字颜色需要通过 @media (prefers-color-scheme: dark) 或 light-dark() 等 CSS 定义。也可以改为在 :root 或 body 上声明 color-scheme: light dark。对于拥有独立主题的区块,应在相应元素上应用声明和对应样式。WebKit 建议将声明包含在初始 HTML 或 CSS 中,而非稍后通过 JavaScript 添加,以便 Safari 从一开始就能正确渲染。

隐私与测试版限制#

Safari 不会向网站告知 Adaptive Dark Mode 是否更改了颜色。通过 JavaScript 读取 CSS 颜色值时,Safari 会返回网站指定的原始值,而非转换后的颜色。WebKit 表示,这是为了避免增加可用于识别或跟踪用户的线索。

因此,开发者需要直接查看实际渲染的页面。通过 JavaScript 读取颜色值,无法确认转换后用户看到的显示效果。

WebKit 也在文档中介绍了 color-scheme: light only,适用于需要保持浅色外观的页面或元素。通过 HTML 为整个页面声明时,使用 <meta name="color-scheme" content="light only">;在 CSS 中,则可以将相同的值应用于 :root 或特定元素。不过,Safari 27.3 测试版 1 尚不支持通过这一声明阻止 Adaptive Dark Mode 转换。虽然这是文档记载的控制方式,但仍需在后续构建版本中确认其阻止转换的效果。

下一步#

在 Safari 27.3 测试版中打开一个有代表性的页面,通过“Try”启用 Adaptive Dark Mode,记录无法阅读的文字、难以辨认的控件以及受到影响的标志。

来源: https://gihyo.jp/article/2026/11/safari-adaptive-dark-mode

目录