JavaScript动态修改CSS根元素变量的正确方法

理解CSS自定义属性与JavaScript交互

css自定义属性（custom properties），通常被称为css变量，允许开发者在css中定义可重用的值。它们通过--前缀声明，并通常在:root选择器中定义，以便在整个文档中全局访问。例如：

:root {
  --white: #fff;
  --dark: #000;
  --currentfont: var(--onikipxfont); /* 默认字体大小 */
  --onpxfont: 10px;
  --onikipxfont: 12px;
  --ondortpxfont: 14px;
  --onaltipxfont: 16px;
}

在JavaScript中，我们可以通过document.documentElement.style.setProperty()方法来动态修改这些CSS变量的值。document.documentElement指向HTML文档的根元素（即html>标签），它是:root选择器所对应的元素。

setProperty()方法接受三个参数：

1. 属性名称 (property name)：CSS自定义属性的名称，例如'--currentfont'。
2. 属性值 (value)：要设置的CSS属性值。
3. 优先级 (priority) (可选)：例如'important'。

常见问题：引用其他CSS变量时的陷阱

在尝试通过JavaScript将一个CSS变量的值设置为另一个CSS变量的引用时，一个常见的错误是直接将变量名作为字符串传递给setProperty()方法。例如：

// 错误示例：将'onikipxfont'视为字符串字面量
document.documentElement.style.setProperty('--currentfont', 'onikipxfont');

这种做法会导致样式失效，因为CSS引擎会将'onikipxfont'视为一个普通的字符串值，而不是对--onikipxfont这个CSS变量的引用。因此，--currentfont将不会获取到12px的值，而是字面量字符串"onikipxfont"，这对于CSS的font-size属性来说是一个无效的值。

立即学习“Java免费学习笔记（深入）”；

正确引用CSS变量的方法：使用var()函数

要正确地将一个CSS变量的值设置为另一个CSS变量的引用，必须在属性值中使用CSS的var()函数。var()函数的作用是读取并应用自定义属性的值。

TapNow

新一代AI视觉创作引擎

下载

// 正确示例：使用var()函数引用CSS变量
document.documentElement.style.setProperty('--currentfont', 'var(--onikipxfont)');

通过将--onikipxfont包裹在var()函数中，我们明确告诉CSS引擎，--currentfont的值应该解析为--onikipxfont所定义的值（即12px）。

完整示例与代码修正

以下是基于原始问题的HTML、CSS和修正后的JavaScript代码，演示了如何正确地实现字体大小的动态切换。

HTML结构

  

    

      
Font Büyüklüğü
      

        
@@##@@10px
        
@@##@@12px
        
@@##@@14px
        
@@##@@16px
      
      
Tema Rengi
      

        
        
        
        
      
    
  

CSS定义

:root {
  /* Colors*/
  --white: #fff;
  --dark: #000;
  --purple: #9051ff;
  --crimson: crimson;
  --black: #0c192c;
  /* Font Sizes*/
  --onpxfont: 10px;
  --onikipxfont: 12px;
  --ondortpxfont: 14px;
  --onaltipxfont: 16px;
  --currentfont: var(--onikipxfont); /* 默认字体大小 */
}

/* 假设某个元素会使用--currentfont */
body {
  font-size: var(--currentfont);
}

/* active 类用于视觉反馈 */
.customize-theme ul li.active {
  border: 1px solid var(--purple); /* 示例样式 */
}

修正后的JavaScript代码

以下是修正后的JavaScript代码，它正确地使用了var()函数来设置--currentfont的值。

const settings = document.getElementById('settings'); // 未在HTML中显示，假设存在
const customizetheme = document.getElementById('ct');
let onpx = document.getElementById('on');
let onikipx = document.getElementById('oniki');
let ondortpx = document.getElementById('ondort');
let onaltipx = document.getElementById('onalti');
// 颜色相关的元素，此处不修改，但保留原始变量声明
let changeforred = document.getElementById('red');
let changeforblack = document.getElementById('black');
let changeforpurple = document.getElementById('purple');
let changefororange = document.getElementById('orange');

// 辅助函数：移除所有字体选项的active类
function removeAllFontActiveClasses() {
  onpx.classList.remove('active');
  onikipx.classList.remove('active');
  ondortpx.classList.remove('active');
  onaltipx.classList.remove('active');
}

onpx.onclick = function() {
  document.documentElement.style.setProperty('--currentfont', 'var(--onpxfont)');
  removeAllFontActiveClasses();
  onpx.classList.add('active');
}

onikipx.onclick = function() {
  document.documentElement.style.setProperty('--currentfont', 'var(--onikipxfont)');
  removeAllFontActiveClasses();
  onikipx.classList.add('active');
}

ondortpx.onclick = function() {
  document.documentElement.style.setProperty('--currentfont', 'var(--ondortpxfont)');
  removeAllFontActiveClasses();
  ondortpx.classList.add('active');
}

onaltipx.onclick = function() {
  document.documentElement.style.setProperty('--currentfont', 'var(--onaltipxfont)');
  removeAllFontActiveClasses();
  onaltipx.classList.add('active');
}

注意事项与最佳实践

1. 始终使用var()函数：当JavaScript需要将一个CSS自定义属性的值设置为另一个自定义属性的引用时，务必使用var(--variable-name)的格式。
2. 语义化变量名：使用清晰、描述性的变量名（如--primary-color、--font-size-base）可以提高代码的可读性和可维护性。
3. 避免硬编码：尽量通过CSS变量来管理样式，而不是在JavaScript中直接设置像素值或其他具体样式，这有助于保持样式的一致性。
4. 优化事件处理：对于多个相似的事件监听器，可以考虑使用事件委托或循环来简化代码，减少重复。例如，可以给所有字体大小选项添加一个共同的类，然后通过一个通用的事件监听器来处理点击事件，并从被点击元素的id或data-*属性中获取要设置的变量名。

总结

通过document.documentElement.style.setProperty()方法与CSS自定义属性的结合，我们可以实现高度灵活和动态的样式控制。理解var()函数在引用其他CSS变量时的关键作用，是有效利用这一机制的基础。遵循本文所述的正确方法，将确保您的JavaScript代码能够准确无误地与CSS变量协同工作，从而构建出响应性强且易于维护的用户界面。