Transition Property

Usage

Use the transition-{properties} utilities to specify which properties should transition when they change.

Prefers-reduced-motion

You can conditionally apply animations and transitions using the motion-safe and motion-reduce variants:

<button class="transition transform hover:-translate-y-1 motion-reduce:transition-none motion-reduce:transform-none ...">
  Hover me
</button>

These variants are not enabled by default, but you can enable them in the variants section of your tailwind.config.js file:

// tailwind.config.js
module.exports = {
  // ...
  variants: {
    transitionProperty: ['responsive', 'motion-safe', 'motion-reduce']
  }
}

Learn more in the variants documentation.

Responsive

To change which properties of an element transition at a specific breakpoint, add a {screen}: prefix to any existing transition-property utility. For example, use md:transition-colors to apply the transition-colors utility at only medium screen sizes and above.

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

Customizing

Property values

By default, Tailwind provides transition-property utilities for seven common property combinations. You change, add, or remove these by customizing the transitionProperty section of your Tailwind theme config.

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        transitionProperty: {
+         'height': 'height',
+         'spacing': 'margin, padding',
        }
      }
    }
  }

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

Variants

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

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

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

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

Disabling

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

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