应使用 CSS 自定义属性（如 --tooltip-color）在 :root 或 :host 中声明语义化颜色变量，避免内联 style 设置或重复命名，确保主题切换、暗色模式及跨组件复用的稳定性与可维护性。
提示框颜色怎么用 CSS 自定义属性控制
直接用 --tooltip-color 这类自定义属性，比硬写 #ff6b35 或 var(--primary) 更灵活，也更贴近语义。关键不是“能不能”，而是变量名是否真能表达用途、是否在组件生命周期里稳定可维护。
为什么不能把颜色值直接塞进 style 属性里
运行时动态设置 style.color 看似快，但会覆盖所有 CSS 变量继承链，导致主题切换失效、暗色模式适配断裂。尤其当提示框嵌套在 Modal 或 Tooltip 组件里时，父级传入的 --tooltip-bg 就完全失联了。
- 避免用
element.style.setProperty('--tooltip-color', '#...')直接改内联变量——它不触发 CSS 级联重算，某些浏览器下甚至不生效 - 优先挂载到根元素或组件容器上：
document.documentElement.style.setProperty('--tooltip-color', 'hsl(12, 80%, 60%)') - 深色模式切换时，别只改
background，同步更新--tooltip-border和--tooltip-text才能保持对比度合规
:host 和 :root 该选哪个作用域
Web Components 里用 :host，普通页面用 :root。混用会导致变量查找失败：比如在 Shadow DOM 内写 :root { --tooltip-color: red }，子元素根本读不到——它只对全局生效，而 Shadow DOM 是隔离的。
- 纯 HTML/CSS 项目：统一用
:root声明，确保所有提示框共享同一套语义变量 - 使用 Lit 或 Stencil 的组件库：在
:host里声明，并通过part或exportparts暴露给外部定制 - 警惕重复声明：如果
:root和某个组件的:host都定义了--tooltip-color，后者仅对该组件有效，且无法被外部 CSS 覆盖（除非加!important，不推荐）
颜色语义命名容易踩的坑
叫 --tooltip-error-color 比 --tooltip-red 强，但比 --color-danger-foreground 弱——前者绑死了“提示框”，后者可复用于按钮、Badge、Alert。真正的问题不在命名长度，而在变量是否跨组件可迁移。
立即学习“前端免费学习笔记（深入）”；
- 避免带容器名的变量：
--tooltip-bg→ 改成--color-surface-popover，这样 Tooltip、Dropdown、Menu 都能用 - 状态色必须带语义后缀：
--color-success不能只表示绿色，要明确是“操作成功反馈色”，和--color-success-border分开管理 - 灰阶不要用
gray-300这类工具类名，改用功能描述：--color-text-secondary、--color-divider
变量一旦注入到 :root，就很难局部回收。上线前多看一眼 DevTools 的 Computed 标签页里 var(--tooltip-color) 到底解析成了什么——有时候你以为它来自主题包，其实被某处 !important 覆盖了，还查不到来源。
