一、变量的声明

声明变量的时候，变量名前面要加两根连词线（—）。

  1. body {
  2.   --foo: #7F583F;
  3.   --bar: #F7EFD2;
  4. }

上面代码中，body选择器里面声明了两个变量：--foo和--bar。

它们与color、font-size等正式属性没有什么不同，只是没有默认含义。所以 CSS 变量（CSS variable）又叫做”CSS 自定义属性”（CSS custom properties）。因为变量与自定义的 CSS 属性其实是一回事。

你可能会问，为什么选择两根连词线（—）表示变量？因为前端框架最喜欢的 $ 被 Sass 变量用掉了。而最常用的 @ 也被 Less 用掉了。官方为了让 CSS 变量也能够在 Sass 及 Less 中使用，无奈只能妥协的使用 —。

各种值都可以放入 CSS 变量。

  1. /* ==================
  2.     :root选择器用于匹配文档的根元素。
  3.         在HTML中根元素始终是HTML元素。
  4.  ==================== */
  5. :root{
  6.   --main-color: #4d4e53;
  7.   --main-bg: rgb(255, 255, 255);
  8.   --logo-border-color: rebeccapurple;
  10.   --header-height: 68px;
  11.   --content-padding: 10px 20px;
  13.   --base-line-height: 1.428571429;
  14.   --transition-duration: .35s;
  15.   --external-link: "external link";
  16.   --margin-top: calc(2vh + 20px);
  17. }
  • 变量名大小写敏感，--header-color和--Header-Color是两个不同变量。
  • 同一个 CSS 变量，可以在多个选择器内声明。优先级高的会替换优先级低的

    二、通过var() 函数使用定义的变量

var()函数用于读取变量。

  1. a {
  2.   color: var(--foo);
  3.   text-decoration-color: var(--bar);
  4. }

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

  1. color: var(--foo, #7F583F);

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

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

var()函数还可以用在变量的声明。

  1. :root {
  2.   --primary-color: red;
  3.   --logo-text: var(--primary-color);
  4. }

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

  1. .foo {
  2.   --side: margin-top;
  3.   /* 无效 */
  4.   var(--side): 20px;
  5. }

上面代码中，变量--side用作属性名，这是无效的

四、作用域

同一个 CSS 变量，可以在多个选择器内声明。读取的时候，优先级最高的声明生效。这与 CSS 的”层叠”（cascade）规则是一致的。
下面是一个例子。

  1. <style>
  2.   :root { --color: blue; }
  3.   div { --color: green; }
  4.   #alert { --color: red; }
  5.   * { color: var(--color); }
  6. </style>
  7. <p>蓝色</p>
  8. <div>绿色</div>
  9. <div id="alert">红色</div>

上面代码中，三个选择器都声明了--color变量。不同元素读取这个变量的时候，会采用优先级最高的规则，因此三段文字的颜色是不一样的。
这就是说，变量的作用域就是它所在的选择器的有效范围。

  1. body {
  2.   --foo: #7F583F;
  3. }
  4. .content {
  5.   --bar: #F7EFD2;
  6. }

上面代码中，变量--foo的作用域是body选择器的生效范围，--bar的作用域是.content选择器的生效范围。
由于这个原因，全局的变量通常放在根元素:root里面，确保任何选择器都可以读取它们。

  1. :root {
  2.   --main-color: #06c;
  3. }

五、响应式布局

CSS 是动态的，页面的任何变化，都会导致采用的规则变化。
利用这个特点，可以在响应式布局的media命令里面声明变量，使得不同的屏幕宽度有不同的变量值。

  1. body {
  2.   --primary: #7F583F;
  3.   --secondary: #F7EFD2;
  4. }
  5. a {
  6.   color: var(--primary);
  7.   text-decoration-color: var(--secondary);
  8. }
  9. @media screen and (min-width: 768px) {
  10.   body {
  11.     --primary:  #F7EFD2;
  12.     --secondary: #7F583F;
  13.   }
  14. }

利用 js 操作 css 变量

CSS 变量提供了 JavaScript 与 CSS 通信的方法。就是利用 js 操作 css 变量。我们可以使用：

  1. <style>
  2.   /* ...和上面 CSS 一致 */  
  3. </style>    
  5. <!-- 呈现黄色字体  -->    
  6. <div class="text-primary">red</div> 
  8. <!-- 呈现蓝色字体，main 选择器定义的颜色  -->    
  9. <main id='primary' class="text-primary">blue</main>
  11. <!-- 呈现紫色字体，当前内联样式表的定义  --> 
  12. <div id="secondary" style='--primary-color: purple" class="text-primary">purple</main>    
  14. <script>
  15. // 设置变量
  16. document.body.style.setProperty('--primary-color', 'yellow');
  18. // 设置变量，js DOM 元素 ID 就是全局变量，所以直接设置 main 即可
  19. // 变为 红色
  20. primary.style.setProperty('--primary-color', 'red');    
  22. // 变为 黄色，因为当前样式被移除了，使用 body 上面样式
  23. secondary.style.removeProperty('--primary-color');
  25. // 通过动态计算获取变量值
  26. getComputedStyle(document.body).getPropertyValue('--primary-color')
  28. </script>

查看兼容性
https://www.caniuse.com/#feat=css-variables

参考文档

CSS 变量教程

http://www.ruanyifeng.com/blog/2017/05/css-variables.html

CSS变量缺省值

https://www.zhangxinxu.com/wordpress/2022/06/css-var-optional-empty-trick/