CSS:supports() 靜態方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 2015 年 9 月以來,該特性已在各大瀏覽器中可用。

CSS.supports() 靜態方法返回一個布林值,指示瀏覽器是否支援給定的 CSS 功能。

語法

js
CSS.supports(propertyName, value)
CSS.supports(supportCondition)

引數

有兩種不同的引數集。第一種允許測試屬性-值對的支援性

propertyName

一個包含要檢查的 CSS 屬性名稱的字串。

value

一個包含要檢查的 CSS 屬性值的字串。

第二種語法接受一個與 @supports 條件匹配的引數

supportCondition

一個包含要檢查的條件的字串。

返回值

如果瀏覽器支援該規則,則返回 true,否則返回 false

示例

在以下示例中,result 是一個布林值,指示瀏覽器是否支援給定的 CSS 功能。

js
result = CSS.supports("text-decoration-style", "blink");
result = CSS.supports("display: flex");
result = CSS.supports("(--foo: red)");
result = CSS.supports("selector(:has(a))");
result = CSS.supports(
  "(transform-style: preserve) or (-moz-transform-style: preserve) or (-webkit-transform-style: preserve)",
);

有關更多示例和語法功能,請參閱 @supports at-rule。

規範

規範
CSS 條件規則模組第 3 級
# dom-css-supports

瀏覽器相容性

另見

  • @supports at-rule,它允許實現相同的功能,但以宣告式方式。
  • CSSSupportsRule CSSOM 類,允許操作 @supports at-rules。