Skip to content

动画库 animations.css ​

一组只动 transform / opacity 的关键帧动画,8 个动画、8 个可直接套用的工具类,不依赖任何框架。 安装:npx taibai@latest add base-animations,落地到 src/styles/modules/animations.css;也可直接拷仓库里的 src/styles/base/animations.css。

效果预览 ​

下面按文件中的真实关键帧取值循环播放,卡片标题就是可以直接写进 animation 的名字。

循环播放仅用于预览,生产用法见下方示例

anim-shake

旧名 rotateClockwise(第 1 段)

竖向下沉 50px + 左右摆 ±50px,末帧收回原点,不再跳位。

anim-shake-x

旧名 rotateClockwise(第 2 段)

纯水平抖动,左右各 100px。

anim-pulse-opacity

旧名 myfirst

透明度 0.2 ↔ 1,适合加载态与骨架屏。

anim-pulse-background

旧名 mysecond(第 1 段)

背景明暗 0.1 ↔ 0.6,只动 background-color。

anim-slide-right

旧名 animove

向右滑出自身 100% 宽度,用于退场。

anim-scroll-left ⇄ anim-scroll-right

旧名 animaheng1 / animaheng2

A
B
A
B

0 → -50% 与 -50% → 0 成对,两份等宽内容交替才无缝。

anim-cursor-blink

AiText 打字光标

|

透明度 1 ↔ 0,0.8s 循环;颜色取 element-plus 主色,没装 EP 时回落 #409eff。

命名对照 ​

旧名对应关系写在每张卡片的第二行,这里只列新名、动作与建议时长。

  • anim-shake — 竖向下沉 50px + 左右摆 ±50px,0.5s
  • anim-shake-x — 水平抖动 ±100px,0.45s
  • anim-pulse-opacity — 透明度 0.2 ↔ 1,1.6s 循环
  • anim-pulse-background — 背景明暗 0.1 ↔ 0.6,2s 循环
  • anim-slide-right — 0 → 自身 100% 宽度,0.4s
  • anim-scroll-left — 0 → -50%,12s 循环
  • anim-scroll-right — -50% → 0,12s 循环
  • anim-cursor-blink — 透明度 1 ↔ 0,0.8s 循环(打字光标,AiText 已改用这一组)

源文件里存在三处同名覆盖,被覆盖的写法是死代码,这里已拆成独立动画:

  • rotateClockwise 声明两次,后一段覆盖前一段,写这个名字实际只会左右抖;
  • mysecond 声明两次,后一段覆盖前一段,背景呼吸从未生效;
  • 抖动动画末帧停在 (0, 50px) 不归位,循环时会跳 50px,已收回原点。

用法 ​

直接套工具类(时长与缓动已内置)

html
<div class="anim-pulse-opacity">加载中…</div>
<div class="anim-shake">表单校验失败</div>
<div class="anim-slide-right">切换时滑出</div>

自己写 animation

css
.error-tip {
  animation: anim-shake 0.5s cubic-bezier(0.36, 0.07, 0.19, 0.97) both;
}

配合 Vue 的 v-if 做入场/退场

vue
<script setup>
import { ref } from 'vue'
const shaking = ref(false)

function fail() {
  shaking.value = false
  requestAnimationFrame(() => (shaking.value = true))
}
</script>

<template>
  <div :class="{ 'anim-shake': shaking }" @animationend="shaking = false">…</div>
</template>

同一个元素重复触发抖动时,需要先移除类、下一帧再加回(如上),否则类名没有变化不会重播。

注意事项 ​

  • 抖动类位移较大,播放期间加 will-change: transform 更顺滑,但不要常驻。
  • anim-scroll-left / anim-scroll-right 是成对的,单份内容使用会在接缝处跳回。
  • 文件末尾已有 prefers-reduced-motion: reduce 守卫,系统开启「减少动态效果」时持续动画会停用。
  • 关键帧里不动 width / height / top / left,避免触发重排;新增动画请沿用这条。

Released under the MIT License.