什么是 AnimeCursor ？

AnimeCursor 是一个让网页拥有 逐帧动画的光标 的前端 JavaScript 库。
不同于 v1 的模拟光标方案，AnimeCursor v2 使用原生 CSS 实现动画光标——无需模拟元素、无需持续的鼠标监听，性能极佳，热点偏移精准。

你只需准备动画光标的独立帧图片，告诉 AnimeCursor 你需要什么光标，它就会自动生成对应的 CSS 规则。整个过程高度定制，且完美保留原生光标的行为特性。

AnimeCursor 专注于 视觉表现，适合以下场景：

• 个性化个人主页

• 像素风 / 复古 UI

• 特殊视觉互动网页

也能很好地融入传统页面：

• 应用后台 / 管理系统

• 表单密集、可访问性要求高的页面

• 需要局部保留系统光标行为的应用

AnimeCursor 提供完整的生命周期 API。你可以通过 disable() 临时恢复系统光标，在需要时再通过 enable() 重新启用动画光标。

※ AnimeCursor 最初是为我的个人网站编写的。后来我意识到不应在每个新项目中重复造轮子，于是将它剥离成独立的库。

特性

• 原生 CSS 光标 – 使用浏览器原生光标，无模拟元素，无额外监听（调试模式除外）。

• 独立帧图片支持 – 支持多张独立图片制作逐帧动画。AnimeCursor 自动识别文件名中的数字序号（如 cursor_01.png → cursor_02.png）。

• 变速动画 – frames 和 duration 可设为数组，实现复杂的动画节奏。

• 自动光标切换 – 通过 HTML 标签或 data-cursor 属性自动切换光标样式。

• 可选调试浮层 – 显示当前光标类型和坐标，方便校准。

• 生命周期 API – refresh()、disable()、enable()、destroy()，完全控制光标行为。

浏览器支持

AnimeCursor 依赖现代 CSS 特性（cursor: url()、@keyframes），不保证在旧浏览器中正常运行。