动画

​基本用法(Basic usage)

​旋转(Spin)

添加 animate-spin 工具，为元素（如加载指示器）添加线性旋转动画。

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

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

​平(Ping)

添加 animate-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.

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

​脉冲(Pulse)

添加 animate-pulse 工具以使元素缓慢淡入淡出——对骨架加载器等内容非常有用。

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

<div class="border border-blue-300 shadow rounded-md p-4 max-w-sm w-full mx-auto">
  <div class="animate-pulse flex space-x-4">
    <div class="rounded-full bg-slate-200 h-10 w-10"></div>
    <div class="flex-1 space-y-6 py-1">
      <div class="h-2 bg-slate-200 rounded"></div>
      <div class="space-y-3">
        <div class="grid grid-cols-3 gap-4">
          <div class="h-2 bg-slate-200 rounded col-span-2"></div>
          <div class="h-2 bg-slate-200 rounded col-span-1"></div>
        </div>
        <div class="h-2 bg-slate-200 rounded"></div>
      </div>
    </div>
  </div>
</div><div class="border border-blue-300 shadow rounded-md p-4 max-w-sm w-full mx-auto">
  <div class="animate-pulse flex space-x-4">
    <div class="rounded-full bg-slate-700 h-10 w-10"></div>
    <div class="flex-1 space-y-6 py-1">
      <div class="h-2 bg-slate-700 rounded"></div>
      <div class="space-y-3">
        <div class="grid grid-cols-3 gap-4">
          <div class="h-2 bg-slate-700 rounded col-span-2"></div>
          <div class="h-2 bg-slate-700 rounded col-span-1"></div>
        </div>
        <div class="h-2 bg-slate-700 rounded"></div>
      </div>
    </div>
  </div>
</div>

​弹跳(Bounce)

添加 animate-bounce 工具来使元素上下弹跳——对“向下滚动”指示器等内容非常有用。

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

<svg class="animate-bounce w-6 h-6 ...">
  <!-- ... -->
</svg>

​Prefers-reduced-motion

对于用户指定偏好减少动画的情况，你可以使用 motion-safe 和 motion-reduce 变体有条件地应用动画和过渡效果：

🌐 For situations where the user has specified that they prefer reduced motion, you can conditionally apply animations and transitions using the motion-safe and motion-reduce variants:

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

​有条件申请

​悬停、聚焦及其他状态

Tailwind 允许你使用变体修饰符在不同状态下有条件地应用工具类。例如，使用hover:animate-spin 仅在 hover 时应用 animate-spin 工具。

<div class="hover:animate-spin">
  <!-- ... -->
</div>

有关所有可用状态修饰符的完整列表，请查看悬停、聚焦、以及其他状态 文档。

​断点和媒体查询

你还可以使用变体修饰符来定位媒体查询，例如响应式断点、暗黑模式、首选减少运动等。例如，使用 md:animate-spin 仅在中等屏幕尺寸及以上时应用 animate-spin 工具。

<div class="md:animate-spin">
  <!-- ... -->
</div>

要了解更多信息，请查看有关 响应式设计、暗黑模式、以及 其他媒体查询修饰符 的文档。

​使用自定义值(Using custom values)

​自定义主题(Customizing your theme)

动画本质上往往高度依赖具体项目。我们默认包含的动画最好被视为有用的示例，我们鼓励你根据自己的需求定制动画，以更好地适应你的项目。

🌐 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.

默认情况下，Tailwind 提供四种不同示例动画的工具类，以及 animate-none 工具类。你可以通过编辑 tailwind.config.js 文件中的 theme.animation 或 theme.extend.animation 来自定义这些值。

🌐 By default, Tailwind provides utilities for four different example animations, as well as the animate-none utility. You can customize these values by editing theme.animation or theme.extend.animation in your tailwind.config.js file.

module.exports = {
  theme: {
    extend: {
      animation: {
        'spin-slow': 'spin 3s linear infinite',
      }
    }
  }
}

要添加新的动画 @keyframes，请使用主题配置中的 keyframes 部分：

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

module.exports = {
  theme: {
    extend: {
      keyframes: {
        wiggle: {
          '0%, 100%': { transform: 'rotate(-3deg)' },
          '50%': { transform: 'rotate(3deg)' },
        }
      }
    }
  }
}

然后，你可以在主题配置的 animation 部分按名称引用这些关键帧：

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

module.exports = {
  theme: {
    extend: {
      animation: {
        wiggle: 'wiggle 1s ease-in-out infinite',
      }
    }
  }
}

在主题自定义文档中了解有关自定义默认主题的更多信息。

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

​任意值(Arbitrary values)

如果你需要使用一次性的 animation 值，而该值没有必要包含在你的主题中，请使用方括号动态生成属性，使用任意值。

<div class="animate-[wiggle_1s_ease-in-out_infinite]">
  <!-- ... -->
</div>

在 任意值 文档中了解有关任意值支持的更多信息。