mcpField
T
tailwindcss-animations

tailwindcss-animations

github.com/josiahsiegel设计与 UI592.4k 次安装19 周前更新
代码仓库

关于 tailwindcss-animations

tailwindcss-animations 是一项介绍 Tailwind CSS 动画与过渡工具类的技能，帮助开发者添加动态效果、定义自定义动画，并兼顾减少动态效果的偏好。

主要功能

  1. 01内置旋转、脉冲、闪烁和弹跳效果
  2. 02过渡属性、时长、缓动与延迟
  3. 03缩放、旋转、位移和倾斜工具类
  4. 04在 v4 中定义自定义动画与缓动
  5. 05减少动态效果的无障碍模式

适用场景

  1. 01添加加载指示器和骨架屏效果
  2. 02制作悬停及按钮交互动画
  3. 03创建自定义淡入或滑动动画
  4. 04遵循减少动态效果的用户偏好

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/josiahsiegel/claude-plugin-marketplace --skill tailwindcss-animations

安装后在 Claude Code 中输入/tailwindcss-animations确认已加载。

附带文件references/animation-patterns.md

详细介绍

Tailwind CSS 动画与过渡

内置动画

旋转

用于加载指示器的连续旋转：

<svg class="animate-spin h-5 w-5 text-blue-500" viewBox="0 0 24 24">
  <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" />
  <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z" />
</svg>
脉冲扩散

用于通知的雷达式脉冲：

<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>
脉动

用于骨架屏加载器的轻微淡入淡出：

<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-2 py-1">
    <div class="h-2 bg-slate-200 rounded"></div>
    <div class="h-2 bg-slate-200 rounded w-5/6"></div>
  </div>
</div>
弹跳

引人注意的垂直弹跳：

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

过渡

过渡属性
类CSS 属性
transition-none无
transition-all所有属性
transition常见属性
transition-colors仅颜色
transition-opacity仅不透明度
transition-shadow仅阴影
transition-transform仅变换
过渡时长
类时长
duration-7575ms
duration-100100ms
duration-150150ms
duration-200200ms
duration-300300ms
duration-500500ms
duration-700700ms
duration-10001000ms
过渡缓动函数
类缓动方式
ease-linear线性
ease-in加速
ease-out减速
ease-in-out先加速，再减速
过渡延迟
类延迟
delay-7575ms
delay-100100ms
delay-150150ms
delay-200200ms
delay-300300ms
delay-500500ms
基本过渡示例

<button class="bg-blue-500 hover:bg-blue-700 transition-colors duration-200">
  Hover me
</button>


<div class="transform hover:scale-105 transition-transform duration-200">
  Card
</div>


<div class="opacity-100 hover:opacity-75 transition-opacity duration-150">
  Fade
</div>


<button class="
  bg-blue-500 hover:bg-blue-700
  transform hover:scale-105
  shadow-md hover:shadow-lg
  transition-all duration-200
">
  Full transition
</button>

变换工具类

缩放
<div class="transform scale-100 hover:scale-110 transition-transform">
  Scale up
</div>

<div class="transform scale-100 hover:scale-90 transition-transform">
  Scale down
</div>


<div class="transform hover:scale-x-110">Horizontal</div>
<div class="transform hover:scale-y-110">Vertical</div>
旋转
<div class="transform hover:rotate-12 transition-transform">
  Rotate right
</div>

<div class="transform hover:-rotate-12 transition-transform">
  Rotate left
</div>

<div class="transform hover:rotate-180 transition-transform duration-500">
  Flip
</div>
平移
<div class="transform hover:translate-x-2 transition-transform">
  Move right
</div>

<div class="transform hover:-translate-y-2 transition-transform">
  Move up
</div>
倾斜
<div class="transform hover:skew-x-3 transition-transform">
  Skew horizontal
</div>

<div class="transform hover:skew-y-3 transition-transform">
  Skew vertical
</div>
变换原点
<div class="origin-center transform hover:rotate-45">Center (default)</div>
<div class="origin-top-left transform hover:rotate-45">Top left</div>
<div class="origin-bottom-right transform hover:rotate-45">Bottom right</div>

自定义动画（v4）

在 @theme 中定义
@theme {
  /* Custom keyframes */
  --animate-fade-in: fade-in 0.5s ease-out;
  --animate-slide-up: slide-up 0.3s ease-out;
  --animate-shake: shake 0.5s ease-in-out;
}

@keyframes fade-in {
  from { opacity: 0; }
  to { opacity: 1; }
}

@keyframes slide-up {
  from {
    opacity: 0;
    transform: translateY(20px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes shake {
  0%, 100% { transform: translateX(0); }
  25% { transform: translateX(-5px); }
  75% { transform: translateX(5px); }
}
用法
<div class="animate-fade-in">Fades in</div>
<div class="animate-slide-up">Slides up</div>
<div class="animate-shake">Shakes on error</div>
自定义缓动
@theme {
  --ease-in-expo: cubic-bezier(0.95, 0.05, 0.795, 0.035);
  --ease-out-expo: cubic-bezier(0.19, 1, 0.22, 1);
  --ease-bounce: cubic-bezier(0.68, -0.55, 0.265, 1.55);
}

<div class="transition-transform ease-bounce duration-300 hover:scale-110">
  Bouncy scale
</div>

无障碍：减少动态效果

motion-safe / motion-reduce

<div class="motion-safe:animate-bounce motion-reduce:animate-none">
  Respects preferences
</div>


<button class="
  motion-safe:transition-all motion-safe:duration-200
  motion-reduce:transition-none
  hover:bg-blue-600
">
  Accessible button
</button>
减少动态效果模式
/* Apply globally */
@media (prefers-reduced-motion: reduce) {
  *,
  ::before,
  ::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

常见动画模式

悬停卡片抬升
<div class="
  transform transition-all duration-200
  hover:-translate-y-1 hover:shadow-lg
  bg-white rounded-lg p-6 shadow
">
  Card content
</div>
按钮按压效果
<button class="
  transform transition-transform duration-100
  active:scale-95
  bg-blue-500 text-white px-4 py-2 rounded
">
  Click me
</button>
加载圆点
<div class="flex space-x-1">
  <div class="w-2 h-2 bg-blue-500 rounded-full animate-bounce [animation-delay:-0.3s]"></div>
  <div class="w-2 h-2 bg-blue-500 rounded-full animate-bounce [animation-delay:-0.15s]"></div>
  <div class="w-2 h-2 bg-blue-500 rounded-full animate-bounce"></div>
</div>
滚动时淡入（使用 JS）
<div class="opacity-0 translate-y-4 transition-all duration-500" data-animate>
  Content that fades in
</div>

// Intersection Observer to trigger animation
const observer = new IntersectionObserver((entries) => {
  entries.forEach(entry => {
    if (entry.isIntersecting) {
      entry.target.classList.remove('opacity-0', 'translate-y-4')
    }
  })
})

document.querySelectorAll('[data-animate]').forEach(el => observer.observe(el))
骨架屏加载器
<div class="animate-pulse">
  <div class="h-4 bg-gray-200 rounded w-3/4 mb-4"></div>
  <div class="h-4 bg-gray-200 rounded w-1/2 mb-4"></div>
  <div class="h-4 bg-gray-200 rounded w-5/6"></div>
</div>
汉堡菜单变为 X 的动画
<button class="group" aria-label="Toggle menu">
  <span class="block w-6 h-0.5 bg-black transition-all duration-200 group-open:rotate-45 group-open:translate-y-1.5"></span>
  <span class="block w-6 h-0.5 bg-black mt-1 transition-opacity duration-200 group-open:opacity-0"></span>
  <span class="block w-6 h-0.5 bg-black mt-1 transition-all duration-200 group-open:-rotate-45 group-open:-translate-y-1.5"></span>
</button>

进入/离开时的过渡（使用 JS）

对于复杂的进入/离开过渡，可以使用 Headless UI 之类的库：

import { Transition } from '@headlessui/react'

function Modal({ isOpen, children }) {
  return (
    <Transition
      show={isOpen}
      enter="transition-opacity duration-300"
      enterFrom="opacity-0"
      enterTo="opacity-100"
      leave="transition-opacity duration-200"
      leaveFrom="opacity-100"
      leaveTo="opacity-0"
    >
      {children}
    </Transition>
  )
}

性能提示

1. 优先使用 GPU 加速属性

<div class="transform hover:translate-x-2 transition-transform">


<div class="hover:left-2 transition-all">
2. 使用特定的过渡

<div class="transition-colors duration-200 hover:bg-blue-500">


<div class="transition-all duration-200 hover:bg-blue-500">
3. 缩短动画时长

<button class="transition-colors duration-150">


<button class="transition-colors duration-1000">
4. 谨慎使用 will-change

<div class="will-change-transform animate-spin">
  Loading spinner
</div>

评论

支持 Markdown