五分钟上手Animate.css:安装配置与第一个动画效果


五分钟上手Animate.css:安装配置与第一个动画效果

安装方式

Animate.css 有三种主流的引入方式,根据项目类型选择。

CDN 引入(最快速)

适合原型验证、单页 HTML、不使用构建工具的项目。把下面这行加到 <head> 里:

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css" integrity="sha512-X7RNRcZ5HYhAqBsr8BGigPsRQi33Ns8u54gDh9oAYB/9JwR5VIaiwGfyVvqcRorJBiR97M/JqBSEe47tMTMDw==" crossorigin="anonymous" referrerpolicy="no-referrer" /> ​

integrity 属性是 SRI(Subresource Integrity)校验值,防止 CDN 被劫持后加载恶意内容。生产环境建议保留。如果不需要 SRI,去掉 integrity 和 crossorigin 即可。

其他 CDN 源也支持:jsDelivr、unpkg、BootCDN。国内项目建议用 BootCDN 或 jsDelivr 的国内节点:

<link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/animate.css/4.1.1/animate.min.css"> ​

npm 安装(项目级)

使用 webpack/vite/rollup 等构建工具的项目,通过 npm 安装:

npm install animate.css # 或 yarn add animate.css # 或 pnpm add animate.css ​

然后在入口文件中引入:

// main.js import 'animate.css'; ​

或者按需引入单个动画(需要配合构建工具的 tree shaking,后文详细讲):

import 'animate.css/animate__fadeInUp.css'; ​

Sass 源码引入(深度定制)

如果你需要修改 Animate.css 的基础变量(如默认时长、缓动函数),可以直接引入 Sass 源码:

// 你的 SCSS 文件 @use 'animate.css/src/animate' with ( $animate-duration: 2s, $animate-delay: 0.5s, $animate-iteration: 1 ); ​

Sass 源码安装在 node_modules/animate.css/src/ 目录下。

03-fig01-2

第一个动画效果

创建一个 index.html 文件:

<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Animate.css 入门</title> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css"> <style> body { font-family: system-ui, sans-serif; padding: 40px; } .box { width: 200px; height: 200px; background: #4361ee; color: white; display: flex; align-items: center; justify-content: center; border-radius: 12px; margin: 20px 0; font-size: 18px; } </style> </head> <body> <h1>Animate.css 第一个动画</h1> <!-- 基础用法:两个类就够了 --> <div class="animate__animated animate__fadeInUp">淡入上升</div> <div class="box animate__animated animate__bounceIn">弹跳进入</div> <div class="box animate__animated animate__zoomIn">缩放进入</div> <div class="box animate__animated animate__rotateIn">旋转进入</div> </body> </html> ​

用浏览器打开这个文件,你会看到四个元素在页面加载时自动播放动画。这就是 Animate.css 最基础的使用方式:animate__animated + 具体动画类名。

animate__animated 是所有动画的基础类,它设置了必要的 animation 属性默认值:

.animate__animated { animation-duration: 1s; animation-fill-mode: both; } ​

animate__fadeInUp 则引用了具体的 @keyframes 规则。两个类配合,浏览器就知道"用什么动画、播放多久、播放后保持什么状态"。

常用动画类速查

Animate.css 的动画分为以下类别(v4.1.1 共 80+ 个):

类别 示例类名 效果描述
Classics animate__bounce, animate__flash, animate__pulse 经典循环动画
Attention Seekers animate__bounce, animate__shakeX, animate__swing 吸引注意力的动画
Back Entrances animate__backInDown, animate__backInLeft 带回弹效果的进入
Back Exits animate__backOutDown, animate__backOutRight 带回弹效果的退出
Bouncing Entrances animate__bounceIn, animate__bounceInUp 弹跳式进入
Bouncing Exits animate__bounceOut, animate__bounceOutDown 弹跳式退出
Fading Entrances animate__fadeIn, animate__fadeInUp, animate__fadeInLeft 淡入进入
Fading Exits animate__fadeOut, animate__fadeOutDown, animate__fadeOutRight 淡出退出
Rotating Entrances animate__rotateIn, animate__rotateInDownLeft 旋转进入
Rotating Exits animate__rotateOut, animate__rotateOutDownRight 旋转退出
Sliding Entrances animate__slideInUp, animate__slideInLeft 滑动进入
Sliding Exits animate__slideOutUp, animate__slideOutRight 滑动退出
Zoom Entrances animate__zoomIn, animate__zoomInUp 缩放进入
Zoom Exits animate__zoomOut, animate__zoomOutDown 缩放退出
Specials animate__hinge, animate__rollIn, animate__lightSpeedIn 特殊效果

完整列表可以直接查看 Animate.css 官方文档,或打开 animate.min.css 搜索 animate__ 前缀。

工具类:调整动画参数

光有动画类还不够,实际项目中经常需要调整动画速度、延迟和重复次数。Animate.css v4 提供了完整的工具类:

速度控制

<div class="animate__animated animate__fadeIn animate__slow">2秒慢速淡入</div> <div class="animate__animated animate__fadeIn">默认1秒</div> <div class="animate__animated animate__fadeIn animate__faster">0.5秒快速</div> <div class="animate__animated animate__fadeIn animate__fast">0.8秒</div> ​

工具类对应的 CSS 变量值:

.animate__slow { animation-duration: 2s; animation-duration: calc(var(--animate-duration) * 2); } .animate__slower { animation-duration: 3s; animation-duration: calc(var(--animate-duration) * 3); } .animate__fast { animation-duration: 0.8s; animation-duration: calc(var(--animate-duration) * 0.8); } .animate__faster { animation-duration: 0.5s; animation-duration: calc(var(--animate-duration) * 0.5); } ​

注意 calc(var(--animate-duration) * 2) 这种写法——如果通过 CSS 变量覆盖了默认时长,工具类会基于覆盖后的值做倍数计算。

延迟控制

<div class="animate__animated animate__fadeInUp animate__delay-1s">延迟1秒</div> <div class="animate__animated animate__fadeInUp animate__delay-2s">延迟2秒</div> <div class="animate__animated animate__fadeInUp animate__delay-3s">延迟3秒</div> <div class="animate__animated animate__fadeInUp animate__delay-4s">延迟4秒</div> <div class="animate__animated animate__fadeInUp animate__delay-5s">延迟5秒</div> ​

重复控制

<!-- 无限循环(常用于 loading 动画) --> <div class="animate__animated animate__pulse animate__infinite">Loading...</div> <!-- 重复2次 --> <div class="animate__animated animate__pulse animate__repeat-2">抖两下</div> <!-- 重复3次 --> <div class="animate__animated animate__bounce animate__repeat-3">弹三下</div> ​

组合示例:交错动画列表

<style> .stagger-item { opacity: 0; } </style> <div class="stagger-item animate__animated animate__fadeInUp animate__delay-1s">第一项</div> <div class="stagger-item animate__animated animate__fadeInUp animate__delay-2s">第二项</div> <div class="stagger-item animate__animated animate__fadeInUp animate__delay-3s">第三项</div> <div class="stagger-item animate__animated animate__fadeInUp animate__delay-4s">第四项</div> ​

延迟类只提供 1s-5s 的整秒选项。如果需要更细的延迟,用 CSS 变量:

.stagger-item:nth-child(1) { --animate-delay: 0.1s; } .stagger-item:nth-child(2) { --animate-delay: 0.2s; } .stagger-item:nth-child(3) { --animate-delay: 0.3s; } .stagger-item:nth-child(4) { --animate-delay: 0.4s; } ​

03-fig02-2

常见陷阱

动画只播放一次。CSS Animation 默认播放一次就结束了。如果需要在同一个元素上重新播放同一个动画,需要先移除类名,触发浏览器重排,再重新添加:

var el = document.querySelector('.my-element'); el.classList.remove('animate__animated', 'animate__fadeIn'); // 触发重排 void el.offsetWidth; el.classList.add('animate__animated', 'animate__fadeIn'); ​

或者用 animation 属性的 none 值来强制重置:

el.style.animation = 'none'; void el.offsetWidth; el.style.animation = ''; ​

animate__animated 不能少。具体动画类(如 animate__fadeIn)只定义了 @keyframes,不包含 animation-name 的绑定。animate__animated 负责设置 animation-duration 和 animation-fill-mode 等基础属性。两个类缺一不可。

延迟类的时序问题。如果元素在动画延迟期间不可见(比如 opacity: 0),你需要让元素在延迟结束前保持初始状态。animation-fill-mode: both(animate__animated 默认设置)已经处理了这个问题——它在延迟期间保持 0% 关键帧的状态。

检查安装是否成功

打开浏览器开发者工具,在 Elements 面板选中一个带动画类的元素,查看 Computed 面板中的 animation 属性。如果能看到 animation-name: fadeInUp、animation-duration: 1s 等值,说明 Animate.css 已正确加载。

如果动画没生效,按这个清单排查:

  1. 检查 <link> 标签的路径是否正确(Network 面板看是否 200)
  2. 检查元素是否同时有 animate__animated 和具体动画类
  3. 检查是否有更高优先级的 CSS 覆盖了 animation 属性
  4. 检查 prefers-reduced-motion 媒体查询是否生效(系统设置中关闭了动画)

03-fig03-2

下一步我们将系统梳理 Animate.css 的全部动画类和工具类,建立完整的知识图谱。

作者与出处
原作者:灏天文库
来源:平台策划编纂
整理人: 灏天文库整理
由灏天文库平台收录,内容或由平台用户上传,仅供学习交流
发布者: 作者: 灏天文库 转发
评论区 (0)
U