大网数据广告活动
Web 标准与前端开发

color-scheme

· 52CE 我爱测

**`color-scheme`** CSS 属性允许元素指示它可以舒适地呈现哪些颜色方案。

color-scheme CSS 属性允许元素指示它可以舒适地呈现哪些颜色方案。

操作系统颜色方案的常见选择为“亮色”和“暗色”,或“日间模式”和“夜间模式”。当用户选择其中一种颜色方案时,操作系统会对用户界面进行调整,包括表单控件、滚动条和 CSS 系统颜色的使用值。

CSS Demo: color-scheme

color-scheme: normal;
color-scheme: dark;
color-scheme: light;
<section class="default-example container" id="default-example">
  <textarea id="example-element">Text Area</textarea>
</section>
#example-element {
  width: 80%;
  height: 50%;
}

语法

color-scheme: normal;
color-scheme: light;
color-scheme: dark;
color-scheme: light dark;
color-scheme: only light;

/* 全局值 */
color-scheme: inherit;
color-scheme: initial;
color-scheme: revert;
color-scheme: revert-layer;
color-scheme: unset;

color-scheme 属性的值必须是以上关键字之一。

取值

  • normal
    • : 表示元素未指定任何配色方案,因此应使用浏览器的默认配色方案呈现。
  • light
    • : 表示可以使用操作系统亮色配色方案渲染元素。
  • dark
    • : 表示可以使用操作系统深色配色方案渲染元素。
  • only
    • : 禁止用户代理覆盖元素的颜色方案。

      可以使用 color-scheme: only light; 应用于特定的元素或 :root,以关闭由 Chrome 的自动深色主题引起的颜色覆盖。

形式定义

形式语法

示例

应用配色方案

要将整个页面配置为使用用户的配色方案首选项,请在 :root 元素上指定 color-scheme。

:root {
  color-scheme: light dark;
}

规范

浏览器兼容性

参见

  • prefers-color-scheme 媒体查询来检测用户对配色方案的偏好。
  • 使用 CSS 将颜色应用于 HTML 元素
  • 其他与颜色相关的属性:color、background-color、border-color、outline-color、text-decoration-color、text-emphasis-color、text-shadow、caret-color 和 column-rule-color
  • background-image
  • print-color-adjust

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。