Animation

Tailwind CSS version

v1.6.0+

Utilities for animating elements with CSS animations.

Class reference

ClassProperties
.animate-noneanimation: none;
.animate-spinanimation: spin 1s linear infinite; @keyframes spin { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
.animate-pinganimation: ping 1s cubic-bezier(0, 0, 0.2, 1) infinite; @keyframes ping { 0% { transform: scale(1); opacity: 1; } 75%, 100% { transform: scale(2); opacity: 0; } }
.animate-pulseanimation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite; @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: .5; } }
.animate-bounceanimation: bounce 1s infinite; @keyframes bounce { 0%, 100% { transform: translateY(-25%); animationTimingFunction: cubic-bezier(0.8, 0, 1, 1); } 50% { transform: translateY(0); animationTimingFunction: cubic-bezier(0, 0, 0.2, 1); } }

Spin

Add the animate-spin utility to add a linear spin animation to elements like loading indicators.

Animation - 图1

  1. <button type="button" class="bg-indigo-600 ..." disabled>
  2. <svg class="animate-spin h-5 w-5 mr-3 ..." viewBox="0 0 24 24">
  3. <!-- ... -->
  4. </svg>
  5. Processing
  6. </button>

Ping

Add the animate-ping utility to make an element scale and fade like a radar ping or ripple of water — useful for things like notification badges.

Animation - 图2

  1. <span class="flex h-3 w-3">
  2. <span class="animate-ping absolute inline-flex h-full w-full rounded-full bg-pink-400 opacity-75"></span>
  3. <span class="relative inline-flex rounded-full h-3 w-3 bg-pink-500"></span>
  4. </span>

Pulse

Add the animate-pulse utility to make an element gently fade in and out — useful for things like skeleton loaders.

Animation - 图3

  1. <div class="border border-gray-300 shadow rounded-md p-4 max-w-sm w-full mx-auto">
  2. <div class="animate-pulse flex space-x-4">
  3. <div class="rounded-full bg-gray-400 h-12 w-12"></div>
  4. <div class="flex-1 space-y-4 py-1">
  5. <div class="h-4 bg-gray-400 rounded w-3/4"></div>
  6. <div class="space-y-2">
  7. <div class="h-4 bg-gray-400 rounded"></div>
  8. <div class="h-4 bg-gray-400 rounded w-5/6"></div>
  9. </div>
  10. </div>
  11. </div>
  12. </div>

Bounce

Add the animate-bounce utility to make an element bounce up and down — useful for things like “scroll down” indicators.

Animation - 图4

  1. <svg class="animate-bounce w-6 h-6 text-gray-900" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" stroke="currentColor">
  2. <path d="M19 14l-7 7m0 0l-7-7m7 7V3"></path>
  3. </svg>

Prefers-reduced-motion

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

  1. <button type="button" class="bg-indigo-600 ..." disabled>
  2. <svg class="motion-safe:animate-spin h-5 w-5 mr-3 ..." viewBox="0 0 24 24">
  3. <!-- ... -->
  4. </svg>
  5. Processing
  6. </button>

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

  1. // tailwind.config.js
  2. module.exports = {
  3. // ...
  4. variants: {
  5. animation: ['responsive', 'motion-safe', 'motion-reduce']
  6. }
  7. }

Learn more in the variants documentation.

Responsive

To change or disable an animation at a specific breakpoint, add a {screen}: prefix to any existing animation utility. For example, use md:animate-none to apply the animate-none utility at only medium screen sizes and above.

  1. <div class="animate-spin md:animate-none ...">
  2. <!-- ... -->
  3. </div>

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

Customizing

Animations by their very nature tend to be highly project-specific. The animations we include by default are best thought of as helpful examples, and you’re encouraged to customize your animations to better suit your needs.

By default Tailwind provides utilities for four different example animations, as well as the animate-none utility. You change, add, or remove these by customizing the animation section of your theme configuration.

  1. // tailwind.config.js
  2. module.exports = {
  3. theme: {
  4. extend: {
  5. animation: {
  6. + 'spin-slow': 'spin 3s linear infinite',
  7. }
  8. }
  9. }
  10. }

To add new animation @keyframes, use the keyframes section of your theme configuration:

  1. // tailwind.config.js
  2. module.exports = {
  3. theme: {
  4. extend: {
  5. keyframes: {
  6. + wiggle: {
  7. + '0%, 100%': { transform: 'rotate(-3deg)' },
  8. + '50%': { transform: 'rotate(3deg)' },
  9. + }
  10. }
  11. }
  12. }
  13. }

You can then reference these keyframes by name in the animation section of your theme configuration:

  1. // tailwind.config.js
  2. module.exports = {
  3. theme: {
  4. extend: {
  5. animation: {
  6. + wiggle: 'wiggle 1s ease-in-out infinite',
  7. }
  8. }
  9. }
  10. }

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

Responsive and pseudo-class variants

By default, only responsive variants are generated for animation utilities.

You can control which variants are generated for the animation utilities by modifying the animation property in the variants section of your tailwind.config.js file.

For example, this config will also generate hover and focus variants:

  1. // tailwind.config.js
  2. module.exports = {
  3. variants: {
  4. // ...
  5. - animation: ['responsive'],
  6. + animation: ['responsive', 'hover', 'focus'],
  7. }
  8. }

Disabling

If you don’t plan to use the animation utilities in your project, you can disable them entirely by setting the animation property to false in the corePlugins section of your config file:

  1. // tailwind.config.js
  2. module.exports = {
  3. corePlugins: {
  4. // ...
  5. + animation: false,
  6. }
  7. }

← Transition Delay   Scale →