通过 JavaScript 访问 CSS 自定义 属性(又名 CSS 变量)

Accessing a CSS custom property (aka CSS variable) through JavaScript

如何使用 JavaScript(普通或 jQuery)获取和设置 CSS 自定义属性(在样式表中使用 var(…) 访问的属性)?

这是我不成功的尝试:单击按钮会更改通常的 font-weight 属性,但不会更改自定义的 --mycolor 属性:

<html>
<head>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.0/jquery.min.js"></script>
  <style>
    body { 
      --mycolor: yellow;
      background-color: var(--mycolor);
    }
  </style>
</head>
<body>

  <p>Let's try to make this text bold and the background red.</p>
  <button onclick="plain_js()">Plain JS</button>
  <button onclick="jQuery_()">jQuery</button>

  <script>
  function plain_js() { 
    document.body.style['font-weight'] = 'bold';
    document.body.style['--mycolor'] = 'red';
  };
  function jQuery_() {
    $('body').css('font-weight', 'bold');
    $('body').css('--mycolor', 'red');
  }
  </script>
</body>
</html>

您可以使用 document.body.style.setProperty('--name', value);:

var bodyStyles = window.getComputedStyle(document.body);
var fooBar = bodyStyles.getPropertyValue('--foo-bar'); //get

document.body.style.setProperty('--foo-bar', newValue);//set

更多信息here

以下示例说明了如何使用 JavaScript 或 jQuery 更改背景,利用自定义 CSS 属性,也称为 CSS 变量(阅读更多here)。奖励:代码还说明了如何使用 CSS 变量来更改字体颜色。

function plain_js() { 
    // need DOM to set --mycolor to a different color 
    d.body.style.setProperty('--mycolor', 'red');
     
    // get the CSS variable ...
    bodyStyles = window.getComputedStyle(document.body);
    fontcolor = bodyStyles.getPropertyValue('--font-color'); //get
 
    // ... reset body element to custom property's new value
    d.body.style.color = fontcolor;
    d.g("para").style["font-weight"] = "bold";
    this.style.display="none";
  };

  function jQuery_() {
    $("body").get(0).style.setProperty('--mycolor','#f3f');
    $("body").css("color",fontcolor);
    $("#para").css("fontWeight","bold");
    $(this).css("display","none");
  }
  
var bodyStyles = null;
var fontcolor = "";
var d = document;

d.g = d.getElementById;
d.g("red").addEventListener("click",plain_js);
d.g("pink").addEventListener("click",jQuery_);
:root {
     --font-color:white;
     --mycolor:yellow;
    }
    body { 
      background-color: var(--mycolor);
      color:#090;
    }
    
    #para {
     font: 90% Arial,Helvetica;
     font-weight:normal;
    }
    
    #red {
      background:red;
    }
    
    #pink {
      background:#f3f;
    }
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
<p id="para">Let's try to make the background red or pink and change the text to white and bold.</p>
  <button id="red">Red</button>
  <button id="pink">Pink</button>

请注意,对于 jQuery,为了将自定义 属性 设置为不同的值,此 actually holds the answer. It uses the body element's get() 方法允许访问基础 DOM 结构和returns body 元素,从而便于代码将自定义 属性 --mycolor 设置为新值。

原生解决方案

标准方法到get/setCSS3变量是.setProperty().getPropertyValue()

如果您的变量是全局变量(在 :root 中声明),您可以使用以下方法获取和设置它们的值。

// setter
document.documentElement.style.setProperty('--myVariable', 'blue');
// getter
document.documentElement.style.getPropertyValue('--myVariable');

然而getter只会return一个var的值,如果已经设置,使用.setProperty()。 如果已经通过 CSS 声明设置,将 return undefined。在这个例子中检查它:

let c = document.documentElement.style.getPropertyValue('--myVariable');
alert('The value of --myVariable is : ' + (c?c:'undefined'));
:root{ --myVariable : red; }
div{ background-color: var(--myVariable); }
  <div>Red background set by --myVariable</div>

为避免意外行为,您必须在调用 .getPropertyValue() 之前使用 getComputedStyle() 方法。 getter 将如下所示:

getComputedStyle(document.documentElement,null).getPropertyValue('--myVariable');

在我看来,访问CSS变量应该更加简单、快速、直观和自然...


我个人的做法

我已经实现了CSSGlobalVariables一个微型(<3kb)javascript 助手,它会自动检测文档中所有活动的 CSS 全局变量并将其打包到一个对象中,为了更容易访问和操作

// get the document CSS global vars
let cssVar = new CSSGlobalVariables();
// set a new value to --myVariable
cssVar.myVariable = 'red';
// get the value of --myVariable
console.log( cssVar.myVariable );

任何应用于对象属性的更改都会自动转换为 CSS 变量。

可用:https://github.com/colxi/css-global-variables