Houdini 的全新 API 提供更聰明的自訂屬性

CSS 中的轉場效果和資料保護

CSS 自訂屬性 (也稱為 CSS 變數) 可讓您在 CSS 中定義自己的屬性,並在整個 CSS 中使用這些屬性的值。雖然自訂屬性在現今非常實用,但也有一些缺點,可能會造成使用上的困難:自訂屬性可以採用任何值,因此可能會意外遭到非預期的值覆寫,而且一律會從父項繼承值,無法進行轉場。Houdini 的 CSS 屬性和值 API 級別 1現已在 Chrome 78 中推出,可克服這些缺點,讓 CSS 自訂屬性變得非常強大!

什麼是 Houdini?

在介紹新 API 之前,我們先快速談談 Houdini。CSS-TAG Houdini Task Force (通常稱為 CSS Houdini 或 Houdini) 的宗旨是「開發能解釋網頁樣式和版面配置『魔力』的功能」。Houdini 規格集合旨在開放瀏覽器算繪引擎的功能,讓使用者能更深入瞭解樣式,並擴充算繪引擎。如此一來,在 JavaScript 中輸入 CSS 值,以及在不影響效能的情況下,填補或發明新的 CSS,終於成為可能。Houdini 有潛力大幅提升網頁創意。

CSS 屬性和值 API 級別 1

CSS 屬性和值 API 級別 1 (Houdini 屬性和值) 可讓我們為自訂屬性提供結構。以下是使用自訂屬性時的現況:

.thing {
  --my-color: green;
}

由於自訂屬性沒有類型,因此可能會以非預期的方式遭到覆寫。舉例來說,假設您使用網址定義 --my-color,會發生什麼情況。

.thing {
  --my-color: url('not-a-color');
  color: var(--my-color);
}

在這裡,由於 --my-color 未輸入,因此不知道網址不是有效的顏色值!使用時,會改用預設值 (color 為黑色,background 為透明)。有了 Houdini Props and Vals,自訂屬性就能註冊,讓瀏覽器知道應該是什麼!

現在,自訂屬性 --my-color 已註冊為顏色!這會告訴瀏覽器允許的值類型,以及如何輸入和處理該屬性!

已註冊屬性剖析

註冊屬性的方式如下:

window.CSS.registerProperty({
  name: '--my-color',
  syntax: '<color>',
  inherits: false,
  initialValue: 'black',
});

它支持下面的選項:

name: string

自訂屬性的名稱。

syntax: string

如何剖析自訂屬性。如需可能值的完整清單,請參閱 CSS 值和單位規格。預設為 *。

inherits: boolean

是否沿用父項的值。預設值為 true。

initialValue: string

自訂屬性的初始值。

正在仔細閱讀「syntax」。有效選項有很多種,從數字、顏色到 <custom-ident> 類型都有。您也可以使用下列值修改這些語法

  • 附加 + 表示接受以空格分隔的語法值清單。舉例來說,<length>+ 是以空格分隔的長度清單
  • 附加 # 表示接受以半形逗號分隔的語法值清單。例如,<color># 是以逗號分隔的清單
  • 在語法或 ID 之間加上 |,表示提供的任何選項都有效。舉例來說,<color># | <url> | magic 允許以半形逗號分隔的顏色清單、網址或 magic 字詞。

Gotchas

Houdini Props and Vals 有兩個注意事項。首先,一旦定義後,就無法更新現有的已註冊屬性,嘗試重新註冊屬性會擲回錯誤,指出該屬性已定義。

其次,與標準屬性不同,已註冊的屬性在剖析時不會經過驗證。而是在計算時進行驗證。這表示在檢查元素屬性時,無效值不會顯示為無效,且在有效屬性後加入無效屬性不會改回有效屬性;不過,無效屬性會改回註冊屬性的預設值。

為自訂屬性加上動畫效果

註冊自訂屬性除了類型檢查外,還有一項有趣的好處:可以為屬性加上動畫效果!基本動畫範例如下:

<script>
CSS.registerProperty({
  name: '--stop-color',
  syntax: '<color>',
  inherits: false,
  initialValue: 'blue',
});
</script>

<style>
button {
  --stop-color: red;
  transition: --stop-color 1s;
}

button:hover {
  --stop-color: green;
}
</style>

將滑鼠游標懸停在按鈕上時,按鈕會從紅色變成綠色!如果不註冊屬性,屬性就會從一個顏色跳到另一個顏色,因為如果不註冊,瀏覽器就不知道一個值和下一個值之間會發生什麼情況,因此無法保證能轉換這些值。不過,這個範例可以進一步製作 CSS 漸層動畫!下列 CSS 可以使用相同的已註冊屬性編寫:

button {
  --stop-color: red;
  background: linear-gradient(var(--stop-color), black);
  transition: --stop-color 1s;
}

button:hover {
  --stop-color: green;
}

這會為 linear-gradient 的自訂屬性建立動畫,進而為線性漸層建立動畫。請查看下方的 Codepen,瞭解完整程式碼的實際運作情形,並親自試用。

結論

Houdini 即將在瀏覽器中推出,並提供全新的 CSS 使用和擴充方式。Paint API 已推出,現在又新增了自訂屬性和值,我們的創意工具箱正在擴充,可讓我們定義類型 CSS 屬性,並用來建立及製作全新且令人興奮的設計。Houdini 問題佇列中也提供更多資訊,您可以在這裡提供意見回饋,並查看 Houdini 的後續發展。Houdini 的存在是為了開發功能,解釋網頁上樣式和版面配置的「魔力」,因此請善用這些神奇功能。