CoderBlog

# 变量

CSS变量是由CSS作者定义的，它包含的值可以在整个文档中重复使用。下面就来通过这篇文章来更好地理解声明式 CSS 变量！

# 1. 基本使用

CSS变量即“自定义属性”，它包含的值可以在整个文档中重复使用。下面来看看CSS变量是如何定义和使用的。

首先，我们要声明一个自定义属性，属性名以两个减号（--）开始，属性值可以是任何有效的CSS值，并且这个属性和其他属性一样可以写在规则集之内：

:root {
  --main-bg-color: #C92E33;
}
1
2
3

通常，最佳实践是将CSS变量定义在根伪类:root下，这样就可以在HTML文档的任何地方访问到它了。在使用CSS变量时，使用 var() 函数包裹所需变量的变量名即可：

div {
  background-color: var(--main-bg-color)
}
1
2
3

除了变量名之外，var() 还有第二个参数——备用值。在发现变量值不可访问的情况下，将使用备用值来代替它：

div {
  background-color: var(--main-bg-color, red);
}
1
2
3

对于CSS变量的备用值，在替换的过程中，会有四种可能：

  • 浏览器不支持 CSS 变量，带有var()的代码行将会被忽略，将使用浏览器的默认值；
  • 浏览器支持变量，并且该变量设置为正确值，则直接使用该变量；
  • 浏览器支持变量，并且变量未设置为任何值，则直接使用备用值；
  • 浏览器支持变量，并且该变量设置为无效值，则使用浏览器的默认值。

我们甚至可以在媒体查询中重新设置变量，这些重新设置的值可以在任何地方使用，这是预处理器变量无法实现的：

<div></div>
<div></div>
<div></div>
<div></div>


:root {
  --width: 25%;
  --margin: 20px;
}

@media (max-width: 400px) {
  :root {
    --width: 50%;
    --margin: 10px;
  }
}

body {
  display: flex;
  flex-wrap: wrap;
}

div {
  flex: 1;
  height: 220px;
  flex-basis: calc(var(--width) - (var(--margin) * 3));
  background: #ccc;
  margin: var(--margin);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

CSS 变量使重用和自定义 CSS 代码成为了可能，因为它们使封装成为可能。假如我们有一个按钮，它的 class 为 flat，代码如下：

button.flat {
	border: 1px solid black;
	background: transparent;
	color: black;
}

button.flat:hover {
	background: black;
	color: white;
}
1
2
3
4
5
6
7
8
9
10

假如我们想要不同的按钮有不同的操作，比如红色的按钮用于危险操作，那么我们就可以使用 danger 类来覆盖对应的样式声明：

button.flat.danger {
	border-color: red;
	color: red;
}

button.flat.danger:hover {
	background: red;
	color: white;
}
1
2
3
4
5
6
7
8
9

如果有很多种颜色和操作，那就需要多次定义样式来覆盖之前的样式。我们可以使用变量来替换颜色：

button {
	--color-initial: black;
	border: 1px solid var(--color, var(--color-initial));
	background: transparent;
	color: var(--color, var(--color-initial));
}

button:hover {
	background: var(--color, var(--color-initial));
	color: white;
}
1
2
3
4
5
6
7
8
9
10
11

现在想要主题化这个按钮，只需要定义--color变量即可：

button.flat.danger {
	--color: red;
}
1
2
3

这样就相当于将CSS代码进行了封装，代码简洁了很多~

# 2. 作用域

我们可以在全局范围内声明 CSS 变量，这些变量可以在整个应用程序中使用。也可以在局部范围内设置 CSS 变量，它只在特定的选择器中可用。

# （1）CSS 全局变量

要在全局范围内声明变量，就要将变量定义在 :root 伪类选择器中：

:root {
  --primary-color: #000;
}

h1 {
  color: var(--primary-color);
}
1
2
3
4
5
6
7

# （2）CSS 局部变量

要在局部范围内声明变量，只需要在选择器中定义变量即可，这样声明的变量只能在该选择器中使用，如果尝试在其他地方使用，它将不会有任何效果：

h2 {
  --h2-color: #999;
  color: var(--h2-color);
}

h3 {
  color: var(--h2-color);  /* 不生效 */
}
1
2
3
4
5
6
7
8

# （3）优先级和继承

现在我们知道了，如果在 :root中定义变量，它将是全局变量；如果在选择器中定义变量，它将是局部变量。那如果在两个地方都声明了同一变量，谁的优先级更高呢？

实际上，CSS变量和JavaScript变量类似，CSS 变量中的局部作用域是优先于全局作用域的。

:root {
  --color: red;
}

h2 {
  --color: orange;
  color: var(--color);
}
1
2
3
4
5
6
7
8

这里<h2>标签中的内容将是橙色的，因为局部变量的优先级比全局变量的优先级更高。

在CSS中是存在继承的概念的，对于CSS变量也是如此。如果没有为元素找到变量，它会从其父元素继承变量值。下面的<h2>标签的内容也将是橙色的，因为<h2>在其选择器中没有找到--color 变量，所以就会在其父级逐级往上查找这个变量：

:root {
  --color: red;
}

body {
  --color: orange;
}

h2 {
  color: var(--color);
}
1
2
3
4
5
6
7
8
9
10
11

# 3. 注意事项

# （1）CSS变量区分大小写

在定义CSS变量时需要注意，CSS变量的变量名（即属性名）对大小写是敏感的，--my-color 和 --My-color 会被认为是两个完全不同的CSS变量。

# （2）避免循环依赖

在定义CSS变量时不能出现循环依赖关系，这会导致页面无法加载：

--variable_name_1 : var(variable_name_2);
--variable_name_2 : var(variable_name_1);
1
2

# （3）CSS 变量不能是属性名

不能使用 CSS 中的现有属性作为 CSS 的变量名。例如，不能使用名称“font-size”来初始化变量。

# 4. 在 JavaScript 中使用

使用 CSS 变量的一大好处就是可以使用 JavaScript 中访问它。

如果通过内联样式来设置 CSS 变量：

<p style="--color: red"></p>
1

可以通过以下代码来获取变量值：

// 获取 <p> 元素
const element = document.querySelector('p');

// 检索CSS变量 --color 
element.style.getPropertyValue('--color'); // 'red'
1
2
3
4
5

如果在CSS文件中设置CSS变量：

p {
  --color: red;
}
1
2
3

需要通过以下形式来获取变量值：

// 获取 <p> 元素
const element = document.querySelector('p');

// 获取CSS变量 --color 
getComputedStyle(element).getPropertyValue('--color'); // 'red'
1
2
3
4
5

当然也可以使用这种形式来获取变量值：

<p style="--color: red"></p>

// 获取 <p> 元素
const element = document.querySelector('p');

// 获取CSS变量 --color
getComputedStyle(element).getPropertyValue('--color'); // 'red'
1
2
3
4
5
6
7

可以通过以下形式使用JavaScript 设置CSS变量：

// 获取 <p> 元素
const element = document.querySelector('p');

// 将 --color 变量设置为 blue 
element.style.setProperty('--color', 'blue');
1
2
3
4
5

# 5. SASS 变量 vs CSS 变量

在CSS变量出现之前，开发人员可能会使用 SASS 变量，它们的目的是相似的，但是SASS变量不够流畅和灵活。

SASS 变量在定义时需在变量名前加上“$”，在使用变量时直接使用定义的变量名即可：

$main-bg-color: #C92E33;

background-color: $main-bg-color;
1
2
3

SASS 的问题就在于它是一个预处理器，所以，任何在 SASS 中声明的变量都需要经过编译才能执行。上述代码就会编译成这样：

background-color: #C92E33;
1

这样才是有效的CSS，代码经过编译后，变量也就消失了。因此，我们不能在 CSS 运行时更改变量值。

除此之外，两者的变量范围也不是不一样的。预处理器SASS中的变量范围就是嵌套的大括号块。而由于 CSS 变量是属性，所以它们的作用域是基于 DOM 的。这意味着 CSS 变量是按元素解析的，而不是按作用域解析的，来看下面的例子：

body {
  --shadow-color: red;
}

button {
  box-shadow: 1px 1px 1px var(--shadow-color);
}

button:hover {
  --shadow-color: blue;
}
1
2
3
4
5
6
7
8
9
10
11

当我们将鼠标悬停在按钮上时，按钮由红色变为了蓝色。那使用预处理器语言 SASS 会是什么结果呢？来看代码：

body {
	$shadow-color: gray;
}

button {
	box-shadow: 1px 1px 1px $shadow-color;
}

button:hover {
	$shadow-color: blue;
}
1
2
3
4
5
6
7
8
9
10
11

这样就会出现语法错误，第六行使用了未定义的变量。因为SASS不知道<button>在 <body>里面（因为它不是使用 CSS 在浏览器中的 HTML 上下文执行的），也不知道 button:hover 是一个按钮，所以定义的两个变量都没有被识别。

CSS 变量与预处理器变量最重要的区别就是CSS变量是动态分配的。它们在页面的整个生命周期中会保持活动状态，当更新它们时，所有引用它们的地方都会更新。因为它们是属性，所以可以通过任何更新 CSS 属性的机制来更新它们：样式表、内联样式，甚至 JavaScript。

下面是 CSS 变量和 SASS 变量的主要区别：

SASS 变量 CSS 变量
静态分配 动态分配
不支持媒体查询 支持媒体查询
需要预处理器进行编译 不需要预处理器处理
增加了一层计算和复杂性 单层直接变量管理

# 6. 浏览器兼容性

目前，CSS 变量已经得到了各大浏览器的支持：

img

← 颜色 →