CSS 【详解】自定义属性（又名 CSS 变量）

声明变量 - -

变量命名规则

支持数字命名
支持使用短横线和空格命名
支持中文等CJK文字
不支持包含$、 $、$ 、^、(、)、%、"等特殊字符的命名，要使用这些特殊字符，需要使用反斜杠转义。

变量值

可以是任意值或表达式

css 复制代码

 --direction: to top;
 --gradientColor: deeppink, deepskyblue;
 --gradient: to top, deeppink, deepskyblue;
 --linear-gradient: linear-gradient(to top, deeppink, deepskyblue);

变量作用域

后代元素可以原封不动地继承祖先元素设置的CSS自定义属性值。

css 复制代码

body {
    --color: deepskyblue;
}
.box {
    background-color: var(--color);
}

全局变量

css 复制代码

:root {
  --borderColor: #ccc;
}

变量的特征

变量值可以相互传递

css 复制代码

body {
    --green: #4CAF50;   
    --successColor: var(--green);
}

css变量不能给自己赋值

css 复制代码

/* 这种写法是非法的 */
--primary-color: var(--primary-color, #2a80eb);

css变量不能用于@media媒体特征的值

css 复制代码

:root {
    --maxWidth: 640px;
}
/* 不合法，语法无效 */
@media (max-width: var(--maxWidth)) {}

CSS变量作为content属性值没有任何效果

css 复制代码

/* 无效 */
.bar::before {
    content: var(--percent);
}

使用变量 var()

css 复制代码

p {  
   background-color: var(--any-what, deepskyblue); 
}

deepskyblue为缺省值，当--any-what无效时使用 deepskyblue

var() 函数参数非法时

css 复制代码

body {
    --color: 20px;
    background-color: deeppink;
    background-color: var(--color, deepskyblue);
}

最终 body 的背景色为 transparent，因为background-color的初始值是transparent

var()函数只要第一个参数值可能有效，哪怕这个参数值是一个乱七八糟的东西，依然会正常解析。如果第一个参数值是不合法的，则var()函数解析为当前CSS属性的初始值或继承值（如果有继承性），也就是按照unset全局关键字的规则渲染。（注意，只是渲染规则类似，并不等同于直接设置unset关键字。）

var() 函数的空格尾随特性

css 复制代码

html {
    font-size: 14px;
}
body {
    --size: 20;
    font-size: 16px;
    font-size: var(--size)px;
}

最终body的font-size大小是14px

原理：此处font-size:var(--size)px等同于font-size:20 px，注意，20后面有一个空格，这属于不合法的font-size属性值。由于语法上var(--size)px又是合法的，因此会重置font-size:16px，最终使用父元素设置的字号大小14px。

改进方案是：

css 复制代码

body {
    --size: 20;   
    font-size: calc(var(--size) * 1px);
}

或

css 复制代码

body {
    --size: 20px;   
    font-size: var(--size);
}

js 获取CSS全局变量的值

js 复制代码

let borderColor= getComputedStyle(document.documentElement).getPropertyValue("--borderColor");

js 复制代码

// 获取 --color CSS变量值
var cssVarColor = getComputedStyle(box).getPropertyValue('--color'); 
// 输出cssVarColor值，结果是deepskyblue 
console.log(cssVarColor);

js 修改CSS全局变量的值

css 复制代码

document.documentElement.style.setProperty("--borderColor","green");

js 设置CSS局部变量的值

html 复制代码

<div id="box">
    <img src="1.jpg" style="border: 10px solid var(--color);">
</div>

js 复制代码

box.style.setProperty('--color', 'deepskyblue');

实战范例

借助CSS计数器在页面中显示CSS变量的值

css 复制代码

/* 有效 */
.bar::before {
    counter-reset: progress var(--percent);
    content: counter(progress);
}

进度条

https://blog.csdn.net/weixin_41192489/article/details/121007837

多处使用的svg图像

css 复制代码

:root {
    --icon-check: url("data:image/svg+xml,%3Csvg viewBox='0 0 32 32'%3E%3Cpath 
fill='green' d='M28.027 5.161l-17.017 17.017-7.007-7.007-3.003 3.003 10.010 10.010 
20.020-20.020z'%3E%3C/path%3E%3C/svg%3E");
}
.icon-check {
    background: var(--icon-check) no-repeat center / 16px;
    /* 尺寸限制 */
    display: inline-block;
    width: 20px; height: 20px;
}
.valid-pass::after {
    content: var(--icon-check);
    /* 尺寸限制 */
    display: inline-block;
    width: 20px; height: 20px;
}

效果见 https://demo.cssworld.cn/new/8/1-3.php

按钮点击特效

效果见 https://demo.cssworld.cn/new/8/1-1.php

css 复制代码

button {
    /* 这里的空格很重要 */
    --open: ;
    color: #2a80eb;
    -webkit-text-fill-color: #fff;
    border-radius: 4px;
    padding: 9px 20px;
    border: 1px solid var(--open, rgba(0,0,0,.1));
    box-shadow: var(--open, inset 0 1px 2px rgba(0,0,0,.1));
    background: var(--open, linear-gradient(#0003, transparent)) currentColor;
    text-shadow: var(--open, -1px -1px #0003);
    transition: .15s;
}
button:active {
    /* 任意全局关键字都可以 */
    --open: inherit;
}

实现原理

--open:;前面有一个空格，也就是--open属性值是一个空格，在语法上是可能有效的。但是空格对于box-shadow和background等CSS属性是无效的，因此，box-shadow和background等CSS属性均解析为初始值
点击按钮触发:active伪类后，会运行--open:inherit这个CSS声明，全局CSS关键字作为CSS自定义属性值一定无效，因此var()函数会使用后备CSS属性值进行渲染

自定义 CSS 函数 keyword()

https://blog.csdn.net/weixin_41192489/article/details/121021277

模拟 attr() 函数

https://blog.csdn.net/weixin_41192489/article/details/121022170