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 组件仅消费这些变量,不自己硬编码两套颜色。

Primary 是组件变体,Hover / Pressed / Disabled 是交互状态,Light / Dark 是主题维度。避免创建 PrimaryHoverDark 这类组合式变体,否则每增加一个主题就要复制整组状态。
用一份页面接入所有状态
新建 index.html,粘贴下面的完整示例,然后直接用现代桌面浏览器打开。:root[data-theme="dark"] 负责主题覆盖;组件内部的 --button-bg 与 --button-fg 负责当前状态取值。将 Hover 规则放在 Pressed 规则之前,确保鼠标按下时 :active 能覆盖同时成立的 :hover。
<!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 是与其他状态可叠加的视觉检查项,不是第五种背景色。
- Default:刷新页面,确认可用按钮背景与当前主题表一致,文字清晰可读。
- Hover:鼠标移入可用按钮,检查 Hover 色值;移出后恢复 Default。
- Pressed:鼠标按住不放,确认切换到 Pressed;松开后若指针仍在按钮上,应回到 Hover。
- Disabled:指针移入并尝试点击禁用按钮,颜色不变,也不触发交互。
- 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 检查目标。禁用控件虽属于对比度要求的例外,也应保持状态可识别,且不能仅靠颜色说明“不可用”。