CSS Properties and Values API

CSS 屬性與值 APICSS Houdini API 家族的一部分,它允許開發者顯式定義他們的 CSS 自定義屬性,從而實現屬性型別檢查、預設值以及控制屬性是否繼承其值。

介面

CSS.registerProperty

定義瀏覽器應如何解析 CSS 自定義屬性。透過 JavaScript 中的 CSS.registerProperty 訪問此介面。

@property

定義瀏覽器應如何解析 CSS 自定義屬性。透過 CSS 中的 @property at-rule 訪問此介面。

示例

以下程式碼將使用 JavaScript 中的 CSS.registerProperty 註冊一個名為 --my-color自定義屬性--my-color 將使用 CSS 顏色語法,預設值為 #c0ffee,並且不繼承其值。

js
window.CSS.registerProperty({
  name: "--my-color",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

使用 CSS 中的 @property at-rule 可以進行相同的註冊:

css
@property --my-color {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

規範

規範
CSS 屬性和值 API Level 1
# the-css-property-rule-interface
CSS 屬性和值 API Level 1
# the-registerproperty-function

瀏覽器相容性

api.CSSPropertyRule

api.CSS.registerProperty_static

另見