UI 视觉设计 / 系统课时

为 Hover 和 Disabled 配置状态值

为 Hover 和 Disabled 配置状态值

本篇把 Primary 按钮的默认、悬停、按下、禁用和键盘焦点状态接入 Design Token,并用同一份组件样式切换 Light 与 Dark 主题。完成后可以直接在浏览器验证色值、状态优先级与禁用行为,避免组件变体和主题覆盖互相冲突。

学习目标

  • 区分组件变体、交互状态与主题三种不同的配置维度。
  • 将状态语义 Token 映射为可复用的 CSS 自定义属性。
  • 用鼠标、键盘及亮暗主题核验各状态的实际表现。

先定义状态值与触发条件

以 Primary 按钮为例,主题决定色值,状态决定何时使用这些色值。下面的十六进制色值是一组可落地的示例;项目已有品牌色阶时,应在保持语义名称不变的前提下替换取值。

状态 浏览器触发条件 Light 背景 Dark 背景
Default 可用且未交互 #155eef #93c5fd
Hover :hover 且未禁用 #004ecb #bfdbfe
Pressed :active 且未禁用 #003eaa #60a5fa
Disabled 原生 disabled 属性 #e5e7eb #334155

文字色也应成对指定:Light 的可用文字为 #ffffff、禁用文字为 #6b7280;Dark 的可用文字为 #0b1220、禁用文字为 #94a3b8。不要只对整个按钮设置 opacity: 0.4,否则文字、背景及焦点表现会一起变淡,难以分别校验。

焦点是另一条并行规则:通过键盘 Tab 导航时使用 :focus-visible 绘制 3px 轮廓线,轮廓与按钮之间留 3px 间距。它可以与 Hover 同时存在,但不应改变 Hover 的背景色;Pressed 仅表示按下瞬间,不等同于有持久切换含义的 aria-pressed。

让语义变量与组件变体各司其职

将 color.action.primary、color.action.primary.hover、color.action.primary.pressed、color.action.disabled 和 color.focus.ring 分别映射到 CSS 语义变量。Light 与 Dark 只覆盖同名语义变量;Primary 组件仅消费这些变量,不自己硬编码两套颜色。

主题、状态语义 Token 与 Primary 按钮的映射关系

Primary 是组件变体,Hover / Pressed / Disabled 是交互状态,Light / Dark 是主题维度。避免创建 PrimaryHoverDark 这类组合式变体,否则每增加一个主题就要复制整组状态。

用一份页面接入所有状态

新建 index.html,粘贴下面的完整示例,然后直接用现代桌面浏览器打开。:root[data-theme="dark"] 负责主题覆盖;组件内部的 --button-bg 与 --button-fg 负责当前状态取值。将 Hover 规则放在 Pressed 规则之前,确保鼠标按下时 :active 能覆盖同时成立的 :hover。

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>按钮状态 Token 验证</title>
  <style>
    :root {
      --color-surface: #ffffff;
      --color-text: #0b1220;
      --color-action-primary: #155eef;
      --color-action-primary-hover: #004ecb;
      --color-action-primary-pressed: #003eaa;
      --color-action-disabled: #e5e7eb;
      --color-on-action: #ffffff;
      --color-on-action-disabled: #6b7280;
      --color-focus-ring: #155eef;
    }

    :root[data-theme="dark"] {
      --color-surface: #0b1220;
      --color-text: #f8fafc;
      --color-action-primary: #93c5fd;
      --color-action-primary-hover: #bfdbfe;
      --color-action-primary-pressed: #60a5fa;
      --color-action-disabled: #334155;
      --color-on-action: #0b1220;
      --color-on-action-disabled: #94a3b8;
      --color-focus-ring: #bfdbfe;
    }

    body {
      margin: 24px;
      background: var(--color-surface);
      color: var(--color-text);
      font: 16px/1.5 system-ui, sans-serif;
    }

    .demo { display: flex; gap: 16px; flex-wrap: wrap; }

    .btn {
      /* 组件只消费语义变量,不写死主题颜色 */
      --button-bg: var(--color-action-primary);
      --button-fg: var(--color-on-action);
      padding: 12px 16px;
      border: 0;
      border-radius: 8px;
      background: var(--button-bg);
      color: var(--button-fg);
      font: inherit;
      cursor: pointer;
    }

    /* active 放在 hover 之后,保证按下状态优先 */
    .btn:hover:not(:disabled) {
      --button-bg: var(--color-action-primary-hover);
    }
    .btn:active:not(:disabled) {
      --button-bg: var(--color-action-primary-pressed);
    }
    .btn:disabled {
      --button-bg: var(--color-action-disabled);
      --button-fg: var(--color-on-action-disabled);
      cursor: not-allowed;
    }
    .btn:focus-visible {
      outline: 3px solid var(--color-focus-ring);
      outline-offset: 3px;
    }
  </style>
</head>
<body>
  <h1>Primary Button 状态</h1>
  <div class="demo">
    <button class="btn" type="button">可交互按钮</button>
    <button class="btn" type="button" disabled>禁用按钮</button>
    <button class="btn" type="button" id="themeToggle">切换主题</button>
  </div>
  <script>
    // 切换根节点主题,让全部组件自动重新取值
    document.querySelector("#themeToggle").addEventListener("click", () => {
      const root = document.documentElement;
      root.dataset.theme = root.dataset.theme === "light" ? "dark" : "light";
    });
  </script>
</body>
</html>

预期结果:初始为 Light,正常按钮背景为 #155eef;鼠标移入变为 #004ecb,按住时变为 #003eaa。点击「切换主题」后,背景分别改为 Dark 的 #93c5fd、#bfdbfe、#60a5fa。禁用按钮始终保持对应主题的禁用背景,且不能被点击。

按交互矩阵验收而不是只看静态截图

分别在 Light 与 Dark 下执行以下检查,至少覆盖 2 个主题 × 5 类可观察状态 = 10 个检查点。其中 Focus 是与其他状态可叠加的视觉检查项,不是第五种背景色。

  1. Default:刷新页面,确认可用按钮背景与当前主题表一致,文字清晰可读。
  2. Hover:鼠标移入可用按钮,检查 Hover 色值;移出后恢复 Default。
  3. Pressed:鼠标按住不放,确认切换到 Pressed;松开后若指针仍在按钮上,应回到 Hover。
  4. Disabled:指针移入并尝试点击禁用按钮,颜色不变,也不触发交互。
  5. Focus:先单击页面空白处,再按 Tab 导航到可用按钮,检查焦点轮廓是否出现且未被容器裁切;原生禁用按钮应被 Tab 跳过。

可在浏览器开发者工具的 Elements → Styles / Computed 中检查 background-color、color 与 outline-color。例如 Dark Hover 的最终背景应是 rgb(191, 219, 254),与 #bfdbfe 一致。切换主题后应立即更新,不需要重新生成组件 CSS。

避免状态优先级与可访问性回退

如果按下时仍显示 Hover,先检查 :active 是否被更靠后的同优先级规则覆盖;如果 Disabled 仍发生颜色变化,检查 Hover 是否忘记排除 :disabled。不要只靠灰色样式模拟禁用,实际的 <button> 必须设置 disabled,才能阻止原生激活并跳过常规键盘焦点。

焦点轮廓不要写成 outline: none 后不提供替代方案。验证时既要在两种主题下保持可辨认的轮廓,也要检查可用按钮文字与背景的对比度;对普通文字以 4.5:1 作为常见 WCAG AA 检查目标。禁用控件虽属于对比度要求的例外,也应保持状态可识别,且不能仅靠颜色说明“不可用”。

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

目录与阅读设置

阅读设置

17

记录一个想法

为 Hover 和 Disabled 配置状态值

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

登录哪都通