今年三月,微軟宣佈 Edge 瀏覽器將支援 CSS 變數。
這個重要的 CSS 新功能,所有主要瀏覽器已經都支援了。本文全面介紹如何使用它,你會發現原生 CSS 從此變得異常強大。
一、變數的宣告
宣告變數的時候,變數名前面要加兩根連詞線(--
)。
1 2 3 4 |
body { --foo: #7F583F; --bar: #F7EFD2; } |
上面程式碼中,body
選擇器裡面宣告瞭兩個變數:--foo
和--bar
。
它們與color
、font-size
等正式屬性沒有什麼不同,只是沒有預設含義。所以 CSS 變數(CSS variable)又叫做“CSS 自定義屬性”(CSS custom properties)。因為變數與自定義的 CSS 屬性其實是一回事。
你可能會問,為什麼選擇兩根連詞線(--
)表示變數?因為$foo
被 Sass 用掉了,@foo
被 Less 用掉了。為了不產生衝突,官方的 CSS 變數就改用兩根連詞線了。
各種值都可以放入 CSS 變數。
1 2 3 4 5 6 7 8 9 10 11 12 13 |
: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()
函式用於讀取變數。
1 2 3 4 |
a { color: var(--foo); text-decoration-color: var(--bar); } |
var()
函式還可以使用第二個引數,表示變數的預設值。如果該變數不存在,就會使用這個預設值。
1 |
color: var(--foo, #7F583F); |
第二個引數不處理內部的逗號或空格,都視作引數的一部分。
1 2 |
var(--font-stack, "Roboto", "Helvetica"); var(--pad, 10px 15px 20px); |
var()
函式還可以用在變數的宣告。
1 2 3 4 |
:root { --primary-color: red; --logo-text: var(--primary-color); } |
注意,變數值只能用作屬性值,不能用作屬性名。
1 2 3 4 5 |
.foo { --side: margin-top; /* 無效 */ var(--side): 20px; } |
上面程式碼中,變數--side
用作屬性名,這是無效的。
三、變數值的型別
如果變數值是一個字串,可以與其他字串拼接。
1 2 |
--bar: 'hello'; --foo: var(--bar)' world'; |
利用這一點,可以 debug(例子)。
1 2 3 |
body:after { content: '--screen-category : 'var(--screen-category); } |
如果變數值是數值,不能與數值單位直接連用。
1 2 3 4 5 |
.foo { --gap: 20; /* 無效 */ margin-top: var(--gap)px; } |
上面程式碼中,數值與單位直接寫在一起,這是無效的。必須使用calc()
函式,將它們連線。
1 2 3 4 |
.foo { --gap: 20; margin-top: calc(var(--gap) * 1px); } |
如果變數值帶有單位,就不能寫成字串。
1 2 3 4 5 6 7 8 9 10 11 |
/* 無效 */ .foo { --foo: '20px'; font-size: var(--foo); } /* 有效 */ .foo { --foo: 20px; font-size: var(--foo); } |
四、作用域
同一個 CSS 變數,可以在多個選擇器內宣告。讀取的時候,優先順序最高的宣告生效。這與 CSS 的”層疊”(cascade)規則是一致的。
下面是一個例子。
藍色
綠色紅色
上面程式碼中,三個選擇器都宣告瞭--color
變數。不同元素讀取這個變數的時候,會採用優先順序最高的規則,因此三段文字的顏色是不一樣的。
這就是說,變數的作用域就是它所在的選擇器的有效範圍。
1 2 3 4 5 6 7 |
body { --foo: #7F583F; } .content { --bar: #F7EFD2; } |
上面程式碼中,變數--foo
的作用域是body
選擇器的生效範圍,--bar
的作用域是.content
選擇器的生效範圍。
由於這個原因,全域性的變數通常放在根元素:root
裡面,確保任何選擇器都可以讀取它們。
1 2 3 |
:root { --main-color: #06c; } |
五、響應式佈局
CSS 是動態的,頁面的任何變化,都會導致採用的規則變化。
利用這個特點,可以在響應式佈局的media
命令裡面宣告變數,使得不同的螢幕寬度有不同的變數值。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
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 變數的瀏覽器,可以採用下面的寫法。
1 2 3 4 |
a { color: #7F583F; color: var(--primary); } |
也可以使用@support
命令進行檢測。
1 2 3 4 5 6 7 |
@supports ( (--a: 0)) { /* supported */ } @supports ( not (--a: 0)) { /* not supported */ } |
七、JavaScript 操作
JavaScript 也可以檢測瀏覽器是否支援 CSS 變數。
1 2 3 4 5 6 7 8 9 10 |
const isSupported = window.CSS && window.CSS.supports && window.CSS.supports('--a', 0); if (isSupported) { /* supported */ } else { /* not supported */ } |
JavaScript 操作 CSS 變數的寫法如下。
1 2 3 4 5 6 7 8 9 |
// 設定變數 document.body.style.setProperty('--primary', '#7F583F'); // 讀取變數 document.body.style.getPropertyValue('--primary').trim(); // '#7F583F' // 刪除變數 document.body.style.removeProperty('--primary'); |
這意味著,JavaScript 可以將任意值存入樣式表。下面是一個監聽事件的例子,事件資訊被存入 CSS 變數。
1 2 3 4 5 6 |
const docStyle = document.documentElement.style; document.addEventListener('mousemove', (e) => { docStyle.setProperty('--mouse-x', e.clientX); docStyle.setProperty('--mouse-y', e.clientY); }); |
那些對 CSS 無用的資訊,也可以放入 CSS 變數。
1 |
--foo: if(x > 5) this.width = 10; |
上面程式碼中,--foo
的值在 CSS 裡面是無效語句,但是可以被 JavaScript 讀取。這意味著,可以把樣式設定寫在 CSS 變數中,讓 JavaScript 讀取。
所以,CSS 變數提供了 JavaScript 與 CSS 通訊的一種途徑。