grayscale()

Baseline 已廣泛支援

此特性已非常成熟,可在多種裝置和瀏覽器版本上使用。自 ⁨2016 年 9 月⁩以來,它已在各大瀏覽器中可用。

grayscale() CSS 函式將輸入影像轉換為灰度。其結果是 <filter-function>

試一試

filter: grayscale(0);
filter: grayscale(0.2);
filter: grayscale(60%);
filter: grayscale(1);
<section id="default-example">
  <img
    class="transition-all"
    id="example-element"
    src="/shared-assets/images/examples/firefox-logo.svg"
    width="200" />
</section>

語法

css
grayscale(amount)

引數

amount 可選

輸入影像轉換為灰度的程度。它被指定為 <number><percentage>。值為 100% 將輸入完全變為灰度,而 0% 則使輸入保持不變。0%100% 之間的值對效果具有線性乘數。用於插值的初始值為 0。預設值為 1

正式語法

<grayscale()> = 
grayscale( [ <number> | <percentage> ]? )

示例

grayscale() 的正確值示例

css
grayscale(0)     /* No effect */
grayscale(.7)    /* 70% grayscale */

grayscale()      /* Completely grayscale */
grayscale(1)
grayscale(100%)

規範

規範
濾鏡效果模組第 1 級
# funcdef-filter-grayscale

瀏覽器相容性

另見

filterbackdrop-filter 屬性值中可用的其他 <filter-function> 函式包括: