CSS变量使用

声明变量

在名字前面加上两根连词线（--）用来声明变量。

body {
  --foo: #7F583F;
  --bar: #F7EFD2;
}

CSS 变量又叫CSS 自定义属性，如果不使用也不会被识别。和其他CSS属性一样，各种属都可以放入 CSS 变量。

:root{
  --main-color: #4d4e53;
  --main-bg: rgb(255, 255, 255);
  --logo-border-color: rebeccapurple;

  --header-height: 68px;
  --content-padding: 10px 20px;

  --base-line-height: 1.428571429;
  --transition-duration: .35s;
  --external-link: "external link";
  --margin-top: calc(2vh + 20px);
}

变量名大小写敏感，--header-color和--Header-Color是两个不同变量。

使用变量

通过--声明变量后只是一个属性，其他属性使用需要通过var()函数来读取变量。

a {
  color: var(--foo);
  text-decoration-color: var(--bar);
}

var()函数还可以使用第二个参数，表示变量的默认值。如果该变量不存在，就会使用这个默认值。

a {
  color: var(--foo, #7F583F);
}

第二个参数不处理内部的逗号或空格，都视作参数的一部分。

var(--font-stack, "Roboto", "Helvetica");
var(--pad, 10px 15px 20px);

同理声明一个新变量也可以使用var()接收其他变量。

:root {
  --primary-color: red;
  --logo-text: var(--primary-color);
}

注意，变量值只能用作属性值，不能用作属性名。

.foo {
  --side: margin-top;
  /* 无效 */
  var(--side): 20px;
}

变量值的类型

如果变量值是一个字符串，可以与其他字符串拼接。

.foo {
  --bar: 'hello';
  --foo: var(--bar)' world';
}

如果变量值是数值，不能与数值单位直接连用。必须使用calc()函数，将它们连接。

.foo {
  --gap: 20;
  /* 无效 */
  margin-top: var(--gap)px;
  /* 有效 */
  margin-top: calc(var(--gap) * 1px);
}

如果变量值带有单位，就不能写成字符串。

.foo {
  /* 无效 */
  --foo: '20px';
  font-size: var(--foo);
  /* 有效 */
  --foo: 20px;
  font-size: var(--foo);
}

作用域

CSS变量 的作用域和CSS属性是一样的。都可以在多个选择器内生命，变量的作用域在它所在的选择器的有效范围。

如果让所有的选择器都可以访问的定义的变量，我们可以把变量定义在根元素:root里面。

:root {
  --main-color: #06c;
}

兼容性处理

对于不支持 CSS 变量的浏览器，可以采用下面的写法。

a {
  color: #7F583F;
  color: var(--primary);
}

也可以使用@support命令进行检测。

@supports ( (--a: 0)) {
  /* supported */
}
@supports ( not (--a: 0)) {
  /* not supported */
}

JavaScript 操作

JavaScript 也可以检测浏览器是否支持 CSS 变量。

const isSupported = window.CSS && window.CSS.supports && window.CSS.supports('--a', 0);
if (isSupported) {
  /* supported */
} else {
  /* not supported */
}

JavaScript 操作 CSS 变量的写法如下。

// 设置变量
document.body.style.setProperty('--primary', '#7F583F');

// 读取变量
document.body.style.getPropertyValue('--primary').trim();
// '#7F583F'

// 删除变量
document.body.style.removeProperty('--primary');