作者： 阮一峰

日期： 2017年5月 9日

今年三月，微軟宣布 Edge 瀏覽器將支持 CSS 變量。

這個重要的 CSS 新功能，所有主要瀏覽器已經都支持了。本文全面介紹如何使用它，你會發現原生 CSS 從此變得異常強大。

一、變量的聲明

聲明變量的時候，變量名前面要加兩根連詞線（--）。

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

上面代碼中，body選擇器裏面聲明了兩個變量：--foo和--bar。

它們與color、font-size等正式屬性沒有什麽不同，只是沒有默認含義。所以 CSS 變量（CSS variable）又叫做"CSS 自定義屬性"

你可能會問，為什麽選擇兩根連詞線（--）表示變量？因為$foo被 Sass 用掉了，@foo被 Less 用掉了。為了不產生沖突，官方的 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() 函數

var()函數用於讀取變量。

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

var()函數還可以使用第二個參數，表示變量的默認值。如果該變量不存在，就會使用這個默認值。

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;
}

上面代碼中，變量--side用作屬性名，這是無效的。

三、變量值的類型

如果變量值是一個字符串，可以與其他字符串拼接。

--bar: ‘hello‘;
--foo: var(--bar)‘ world‘;

利用這一點，可以 debug（例子）。

body:after {
  content: ‘--screen-category : ‘var(--screen-category);
}

如果變量值是數值，不能與數值單位直接連用。

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

上面代碼中，數值與單位直接寫在一起，這是無效的。必須使用calc()函數，將它們連接。

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

如果變量值帶有單位，就不能寫成字符串。

/* 無效 */
.foo {
  --foo: ‘20px‘;
  font-size: var(--foo);
}

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

四、作用域

同一個 CSS 變量，可以在多個選擇器內聲明。讀取的時候，優先級最高的聲明生效。這與 CSS 的"層疊"（cascade）規則是一致的。

下面是一個例子。

<style>
  :root { --color: blue; }
  div { --color: green; }
  #alert { --color: red; }
  * { color: var(--color); }
</style>

<p>藍色</p>
<div>綠色</div>
<div id="alert">紅色</div>

上面代碼中，三個選擇器都聲明了--color變量。不同元素讀取這個變量的時候，會采用優先級最高的規則，因此三段文字的顏色是不一樣的。

這就是說，變量的作用域就是它所在的選擇器的有效範圍。

body {
  --foo: #7F583F;
}

.content {
  --bar: #F7EFD2;
}

上面代碼中，變量--foo的作用域是body選擇器的生效範圍，--bar的作用域是.content選擇器的生效範圍。

由於這個原因，全局的變量通常放在根元素:root裏面，確保任何選擇器都可以讀取它們。

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

五、響應式布局

CSS 是動態的，頁面的任何變化，都會導致采用的規則變化。

利用這個特點，可以在響應式布局的media命令裏面聲明變量，使得不同的屏幕寬度有不同的變量值。

body {
  --primary: #7F583F;
  --secondary: #F7EFD2;
}

a {
  color: var(--primary);
  text-decoration-color: var(--secondary);
}

@media screen and (min-width: 768px) {
  body {
    --primary:  #F7EFD2;
    --secondary: #7F583F;
  }
}

六、兼容性處理

對於不支持 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‘);

這意味著，JavaScript 可以將任意值存入樣式表。下面是一個監聽事件的例子，事件信息被存入 CSS 變量。

const docStyle = document.documentElement.style;

document.addEventListener(‘mousemove‘, (e) => {
  docStyle.setProperty(‘--mouse-x‘, e.clientX);
  docStyle.setProperty(‘--mouse-y‘, e.clientY);
});

那些對 CSS 無用的信息，也可以放入 CSS 變量。

--foo: if(x > 5) this.width = 10;

上面代碼中，--foo的值在 CSS 裏面是無效語句，但是可以被 JavaScript 讀取。這意味著，可以把樣式設置寫在 CSS 變量中，讓 JavaScript 讀取。

所以，CSS 變量提供了 JavaScript 與 CSS 通信的一種途徑。

八、參考鏈接

• Winning with CSS Variables
• CSS Variables: Why Should You Care?
• It‘s Time To Start Using CSS Custom Properties
• Why I‘m Excited About Native CSS Variables

（完）

轉自 http://www.ruanyifeng.com/blog/2017/05/css-variables.html 阮一峰

CSS 變量教程