版面與 CSS 深入了解 A2 · 正式技術規格

CSS Custom Property

CSS 自訂屬性

CSS 自訂屬性是可重複使用的 CSS 值,也常稱為 CSS 變數。它會遵循串接規則,並能依作用範圍或主題改變。

看看怎麼運作
也有人這樣說 CSS Custom PropertyCSS 變數自訂變數

看看怎麼運作

原創情境範例CSS 自訂屬性

另一個例子

卡片會從目前啟用的淺色或深色主題取得 --surface 和 --text 值。

主要部分

  1. 01基礎或 Token
  2. 02套用後的元件
  3. 03可見狀態與規則

什麼時候用

主題、設計 token 或多處 CSS 要共用的值,適合使用自訂屬性。

什麼時候不要用

不要用全域自訂屬性存放頁面內容,也不要把每個只用一次的數字都放進去。

程式裡的名稱

--token-name

上線前要檢查

檢查內容先後順序、共用設計變數、元件一致性、對比、縮放,以及版面能否隨螢幕大小調整。驗證每個主題、語系與狀態;有動態效果時,也要提供同樣完整的減少動態效果版本。

可以直接複製的需求

預期成果:定義或使用 CSS 自訂屬性 (CSS Custom Property),做出清楚、一致又好用的視覺體驗。 使用者情境:卡片會從目前啟用的淺色或深色主題取得 --surface 和 --text 值。 要運用的設計概念:CSS 自訂屬性 (CSS Custom Property)。 適用理由:主題、設計 token 或多處 CSS 要共用的值,適合使用自訂屬性。 不應使用的情況:不要用全域自訂屬性存放頁面內容,也不要把每個只用一次的數字都放進去。 設計要求:定義內容先後順序、可重用的設計變數(Token)與元件。說明版面如何隨螢幕大小和狀態改變。分清楚必要的設計方向與純裝飾。 包容性與韌性:檢查對比、縮放、多語系、主題切換與減少動態效果。不能只靠顏色或特效傳達意思。 驗收條件:在手機、桌面、縮放、各種主題與所有支援語系中仍清楚可讀。每個互動狀態都一致且容易理解。 證據與限制(證據邊界):正式文件仍可能是草案、候選版或最終版。請查看文件狀態,也要確認瀏覽器或平台是否支援。 待確認:品牌限制、內容多寡、支援的主題與語系、目標裝置,以及現有設計系統規則。

檢查這份需求

請 AI 程式助手檢查目前如何使用 CSS 自訂屬性 (CSS Custom Property)。 定義:CSS 自訂屬性是可重複使用的 CSS 值,也常稱為 CSS 變數。它會遵循串接規則,並能依作用範圍或主題改變。 正式環境檢查:檢查內容先後順序、共用設計變數、元件一致性、對比、縮放,以及版面能否隨螢幕大小調整。驗證每個主題、語系與狀態;有動態效果時,也要提供同樣完整的減少動態效果版本。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

A2
這個術語有多正式?

正式技術規格

一份已發布、有版本的正式技術規格,在列出的範圍內定義這個術語。

正式文件仍可能是草案、候選版或最終版。請查看文件狀態,也要確認瀏覽器或平台是否支援。

適用範圍
只包含來源有說明的內容:正式名稱、定義、語意、實作
文件狀態
草案
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · W3C CSS Working Group · 草案 CSS Custom Properties for Cascading Variables Level 1 — Defining custom properties Defining custom properties 適用範圍: 正式名稱、定義、語意、實作 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 語意, 實作 正式來源 · W3C CSS Working Group · 草案 CSS Custom Properties for Cascading Variables Level 1 適用範圍: 正式名稱、定義、語意、實作 本頁用途: 只支援寫明的範圍 來源涵蓋內容: 正式名稱, 定義, 語意, 實作

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。