「及時」模式:全新世代的 Tailwind CSS
Tailwind CSS on GitHub

Brightness

Tailwind CSS version
v2.1+

Utilities for applying brightness filters to an element.

Default class reference

Class
屬性
brightness-0--tw-brightness: brightness(0);
brightness-50--tw-brightness: brightness(.5);
brightness-75--tw-brightness: brightness(.75);
brightness-90--tw-brightness: brightness(.9);
brightness-95--tw-brightness: brightness(.95);
brightness-100--tw-brightness: brightness(1);
brightness-105--tw-brightness: brightness(1.05);
brightness-110--tw-brightness: brightness(1.1);
brightness-125--tw-brightness: brightness(1.25);
brightness-150--tw-brightness: brightness(1.5);
brightness-200--tw-brightness: brightness(2);

Usage

Use the brightness-{amount?} utilities alongside the filter utility to control an element’s brightness.

<div class="filter brightness-125 ...">
  <!-- ... -->
</div>

Responsive

To control an element’s brightness at a specific breakpoint, add a {screen}: prefix to any existing brightness utility. For example, use md:brightness-150 to apply the brightness-150 utility at only medium screen sizes and above.

<div class="filter brightness-110 md:brightness-150 ...">
  <!-- ... -->
</div>

For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.

Customizing

You can customize which brightness utilities are generated using the brightness key in the theme section of your tailwind.config.js file.

  // tailwind.config.js
  module.exports = {
    theme: {
+     extend: {
+       brightness: {
+         25: '.25',
+         175: '1.75',
+       }
+     }
    }
  }

Learn more about customizing the default theme in the theme customization documentation.

Variants

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

tailwind.config.jsvariants 區塊中變更 brightness 屬性來決定有哪些變化模式會生成。

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

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

Disabling

如果你不打算在專案中使用 brightness 功能,可以在你的設定檔裡的 corePlugins 屬性中將 brightness 設定為 false 來停用功能:

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