通过 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 变量。
如何使用 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,为了将自定义 属性 设置为不同的值,此 --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 变量。