Backdrop Grayscale (背景灰階)

用法

視背景渲染需求，如灰階，將 backdrop-grayscale 功能跟 backdrop-filter 搭配使用。如全彩，將 backdrop-grayscale-0 功能跟 backdrop-filter 搭配使用。

<div class="backdrop-filter backdrop-grayscale ...">
  <!-- ... -->
</div>

響應式

如要讓元素的背景灰階有響應式效果，可在現有背景灰階功能前加上前綴詞 {screen}: 。例如：中型或以上的螢幕尺寸使用 md:backdrop-grayscale-0 以套用 backdrop-grayscale-0 功能。

<div class="backdrop-filter backdrop-grayscale md:backdrop-grayscale-0 ...">
  <!-- ... -->
</div>

更多有關 Tailwind 響應式設計功能的資訊，可參考 響應式設計 文件。

客製化

你可以在tailwind.config.js的theme區塊中，使用backdropGrayscale這個 key 來客製化你要的backdrop-grayscale效果。

  // tailwind.config.js
  module.exports = {
    theme: {
+     extend: {
+       backdropGrayscale: {
+         50: '.5',
+       }
+     }
    }
  }

更多有關客製化預設主題的資訊，可參考主題客製化文件。

變化模式

默認情況下, 只有 響應式 的 backdrop grayscale 變化模式 (variants) 會產生。

在 tailwind.config.js 的 variants 區塊中變更 backdropGrayscale 屬性來決定有哪些變化模式會生成。

舉個例子來說，這個設定將會生成 響應式 和 hover 的變化模式。

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       backdropGrayscale: ['responsive', 'hover'],
      }
    }
  }

停用

如果你不打算在專案中使用 backdrop grayscale 功能，可以在你的設定檔裡的 corePlugins 屬性中將 backdropGrayscale 設定為 false 來停用功能：

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     backdropGrayscale: false,
    }
  }