UI 视觉设计 / 系统课时

用 CSS 自定义属性引用语义色

用 CSS 自定义属性引用语义色

订单工作台同时提供浅色与深色主题时,如果在按钮和卡片中直接写十六进制色值,同一角色很容易出现多套颜色。本篇用 CSS 自定义属性集中定义语义色,让组件只引用“文字、表面、操作按钮”等职责,再通过一个主题属性切换整套配色。

学习目标

  • 区分色值与语义角色,为文字、表面和操作按钮命名。
  • 用 var() 让同一份组件 CSS 适配浅色与深色主题。
  • 验证最终渲染色,并定位变量缺失或被覆盖的问题。

用角色名取代散落的色值

不要在每个按钮里写 background-color: #175cd3,再为深色主题额外复制一份按钮样式。组件真正需要的是“主操作背景”,因此引用 background-color: var(--color-action-bg)。主题负责决定这个角色在当前环境下究竟取深蓝还是浅蓝。

常用命名可先覆盖 --color-page-bg(页面背景)、--color-surface(卡片表面)、--color-text(主要文字)、--color-border(边框)和 --color-action-bg(操作按钮背景)。按钮前景文字另用 --color-action-text,避免换了背景却忘记同步调整文字对比度。

浅色和深色主题共用语义颜色变量并映射到同一组件

运行一张可切换主题的订单卡片

将以下内容保存为 index.html,用浏览器打开。示例把主题变量定义在 :root,然后用根节点的 data-theme="dark" 覆盖同名变量。组件选择器只写一次,所有颜色都从语义入口读取。

html
<!doctype html>
<html lang="zh-CN" data-theme="light">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>语义颜色示例</title>
  <style>
    :root {
      /* 浅色主题在根节点提供默认语义值。 */
      --color-page-bg: #f3f6fa;
      --color-surface: #ffffff;
      --color-text: #172b4d;
      --color-text-muted: #52647a;
      --color-border: #cbd5e1;
      --color-action-bg: #175cd3;
      --color-action-text: #ffffff;
    }
    [data-theme="dark"] {
      /* 切换主题只覆盖变量,不重复声明组件规则。 */
      --color-page-bg: #0f172a;
      --color-surface: #1e293b;
      --color-text: #f8fafc;
      --color-text-muted: #cbd5e1;
      --color-border: #475569;
      --color-action-bg: #93c5fd;
      --color-action-text: #0f172a;
    }
    body {
      margin: 0;
      min-height: 100vh;
      box-sizing: border-box;
      padding: 32px;
      font-family: system-ui, sans-serif;
      background-color: var(--color-page-bg);
      color: var(--color-text);
    }
    .order-card {
      max-width: 420px;
      padding: 24px;
      border: 1px solid var(--color-border);
      border-radius: 12px;
      background-color: var(--color-surface);
    }
    .order-card__detail {
      color: var(--color-text-muted);
    }
    .action-button {
      padding: 10px 16px;
      border: 0;
      border-radius: 8px;
      background-color: var(--color-action-bg);
      color: var(--color-action-text);
      cursor: pointer;
    }
  </style>
</head>
<body>
  <main class="order-card">
    <h1>订单 #1042</h1>
    <p class="order-card__detail">待处理 · 商品 2 件</p>
    <button class="action-button" id="theme-toggle" type="button">切换主题</button>
  </main>
  <script>
    const button = document.querySelector("#theme-toggle");
    button.addEventListener("click", () => {
      const root = document.documentElement;
      // 根节点属性变化后,后代重新获得相应语义色。
      root.dataset.theme = root.dataset.theme === "light" ? "dark" : "light";
    });
  </script>
</body>
</html>

预期结果:首次打开时,页面为浅灰背景、白色卡片和深蓝色按钮;点击“切换主题”后,页面变为深色,卡片与文字同步更新,按钮变为浅蓝底配深色文字;再次点击恢复浅色主题。

在浏览器中核对最终颜色

  1. 在页面上按 F12 打开开发者工具,进入 Elements(元素)面板,选中 .action-button。
  2. 在 Styles(样式)中找到 background-color: var(--color-action-bg),检查该变量由 :root 或 [data-theme="dark"] 提供。
  3. 在 Computed(计算样式)中检查 background-color:浅色时应为 rgb(23, 92, 211),深色时应为 rgb(147, 197, 253)。再检查卡片背景分别为 rgb(255, 255, 255) 和 rgb(30, 41, 59)。
  4. 修改深色主题的 --color-action-bg,确认按钮随之改变,而 .action-button 的 CSS 无须改动。

这些数值是本示例颜色换算后的结果;浏览器开发者工具的界面名称或颜色展示格式可能不同,但对应的实际颜色应一致。

处理变量缺失和局部覆盖

CSS 自定义属性区分大小写,--color-text 与 --Color-Text 是两个名称。写错名称且没有回退值时,依赖它的颜色声明可能失效。对于允许降级的非关键场景,可以写 border-color: var(--color-border, #cbd5e1),让变量缺失时使用后备值;后备值不能修复已经定义、但不符合颜色语法的变量。

变量遵循层叠与继承。如果某张卡片自己声明 --color-action-bg: #000000,其内部按钮就可能优先使用局部值,而不是根节点的主题值。排查时先检查按钮自身和祖先节点,再检查 :root 与主题选择器。要让所有按钮一致,删除无意的局部覆盖;要保留特殊按钮,则为其明确设定组件变体令牌。

主题切换时应成对检查按钮背景与前景色:本例浅色为深蓝配白字,深色为浅蓝配深字。交付前分别在两种主题下核对正文、按钮文字及边框的可读性,不能只确认颜色变量确实发生了变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 CSS 自定义属性引用语义色

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通