逻辑颜色属性是描述颜色在UI中作用而非具体值的CSS变量，如--color-text-emphasis；它实现设计意图与实现解耦，支持主题切换、无障碍适配与工具链校验。
逻辑颜色属性是什么？不是“换个名字而已”
逻辑颜色属性指的是像 --text-primary、--border-subtle、--surface-card 这类不带具体语义（如 “blue”、“dark”）的 CSS 变量名。它描述的是颜色在 UI 中的**作用**，而不是它的物理值或明暗状态。
很多人一开始会把 --primary-color 当作逻辑属性——但其实不是。如果这个变量在 Light Mode 下是 #0066cc，Dark Mode 下硬编码成 #3399ff，那它还是“品牌色”的映射，本质仍是视觉值绑定；真正的逻辑属性应该只表达“谁用它”“在哪用”，比如 --color-text-emphasis，由主题层决定它在不同模式下分别取什么值。
- ✅ 正确示例：
--color-text-emphasis（强调文本色）、--color-border-divider（分隔线色） - ❌ 容易踩的坑：用
--color-blue-500或--dark-bg命名——前者暴露了调色板结构，后者绑定了模式，失去解耦能力
为什么必须用逻辑命名？否则 CSS 变量就白用了
如果你在 :root 里写 --primary-color: #007bff，再通过 JS 切换 data-theme="dark" 并覆盖该变量，看似实现了主题切换——但只要组件样式里直接引用了 --primary-color，它就仍承担着“品牌主色”+“按钮背景”+“链接文字”三重职责，一旦设计规范要求“按钮用深蓝、链接用浅蓝”，你就得加新变量、改 JS、补 CSS，整个链条重新耦合。
逻辑命名把责任切干净：
立即学习“前端免费学习笔记（深入）”；
-
--color-interactive-primary→ 仅用于可点击元素（按钮、链接） -
--color-text-heading→ 仅用于标题层级文字 -
--color-surface-inset→ 仅用于卡片/弹窗等浮层背景
这样，设计师调整“标题文字对比度”时，只需改一个变量；开发者无需动任何组件代码；深色模式只需在 [data-theme="dark"] 块里批量重定义这些逻辑变量——没有 JS 遍历，没有 runtime update 调用。
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档，供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图，还原页面结构与交互，强制套用固定文档模板，抽取跨页面共享规则，或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
Highcharts v13 的 --highcharts-color-n 是典型反面教材？不，是过渡态范本
Highcharts v13 引入的 --highcharts-color-n 看似“逻辑”，实则是数据序列索引的映射，仍保留了“第1个系列用第1个色”的强顺序假设。它比硬编码 colors: ['#007aa6', ...] 好，但还没到真正语义化——比如仪表盘里“预警值柱子”和“正常值柱子”应有不同语义色，而不只是“第2个 vs 第3个”。
真正推荐的做法是：在业务层定义 --color-series-warning 和 --color-series-normal，Highcharts 配置中用 color: var(--color-series-warning) 显式绑定，而不是依赖 --highcharts-color-1 的隐式顺序。
- 好处：图表颜色不再随系列顺序变化而漂移；A/B 测试可单独控制某类数据色；无障碍场景下可替换为高对比度色值
- 注意：Highcharts 默认 palette 不支持这种粒度，需配合
plotOptions.series.color手动注入，不能全靠 CSS 变量自动 fallback
逻辑颜色 + @property 是未来三年最稳的组合
CSS @property 允许你声明变量类型、初始值和继承行为，这对逻辑颜色至关重要。例如：
:root {
@property --color-text-emphasis {
syntax: '<color>',
inherits: false,
initial-value: #1a1a1a;
}
}
这带来两个实际收益：
- 浏览器能校验赋值合法性（比如你误写
--color-text-emphasis: 'red'会被忽略，而不是静默失败） - 配合
transition实现颜色渐变动画（原生 CSS 变量不支持 color 插值，但@property声明后就可以） - 工具链（如 VS Code 插件、Stylelint）能基于类型做智能提示和 lint
目前 Safari 16.4+、Chrome 122+、Firefox 125+ 已支持，Edge 同步跟进。别等“全覆盖”——关键业务组件先用，非关键路径降级为普通变量即可。
逻辑颜色不是多此一举的抽象，它是把“设计意图”翻译成机器可读、可验证、可组合的最小单元。一旦变量名开始描述“用途”而非“样子”，你就已经站在架构升级的起点上了。
