@animateicons/vanilla

中文文档
0.2.0发布于 2026/10/25MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1877

平原JavaScript的动画SVG图标,网络组件和每个框架. 与@animateicons/反应相同,不需要框架.

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 自定义元素
  4. 光盘N
  5. 选项
  6. 许可证

@ animaticons/ vanilla (韩语)

1170平原JavaScript的动画SVG图标,网页组件和每个没有自有软件包的框架(Svelte, Solid,Astro,服务器模板). 同样的动议: @animateicons/react,不需要框架.

npm license

文档 : 动能.in/icons/docs/vanilla。浏览每个图标 动能. in。 。 。 .

安装

npm i @animateicons/vanilla

使用量

每个图标都是纯数据,从 lucide 或者说 huge 子路径。 名称是 PascalCase 中的图标名称 : bell-ring 实值 BellRing。 。 。 .

import { createIcon } from "@animateicons/vanilla";
import { BellRing } from "@animateicons/vanilla/lucide";

const icon = createIcon(BellRing, { size: 32, color: "tomato" });
document.querySelector("#bell").append(icon);

图标动画在悬浮。 打电话 icon.startAnimation() 财务报告和审定财务报表 icon.stopAnimation() 自己弹,和 icon.destroy() 当取去.

自定义元素

注册您曾经使用的图标, 然后在任何地方, 包括 Svelte、 Solid 或 Astro 页面内写入标记 :

<script type="module">
    import { defineIcons } from "@animateicons/vanilla";
    import { Bell, Heart } from "@animateicons/vanilla/lucide";

    defineIcons({ Bell, Heart });
</script>

<animate-icons name="bell" size="32" color="tomato"></animate-icons>

属性 : name, (中文(简体) ), library (单位:千美元)lucide 或者说 huge,只有在两者都有名字时才需要, size, (中文(简体) ), color, (中文(简体) ), duration 财务报告和审定财务报表 is-animated。该元素有 startAnimation() 财务报告和审定财务报表 stopAnimation()。 。 。 .

光盘N

对于没有构建步骤的页面,一个脚本记录一个库的每个图标:

<script src="https://cdn.jsdelivr.net/npm/@animateicons/vanilla/dist/cdn/lucide.js"></script>

<animate-icons name="bell"></animate-icons>

使用 dist/cdn/huge.js 为巨大的图标。 剧本也暴露了 AnimateIcons.createIcon, (中文(简体) ), AnimateIcons.defineIcons 财务报告和审定财务报表 AnimateIcons.icons。它持有库的每个图标(Lucide大约为84 kB,大而压缩的为113 kB),因此在拥有捆绑器时更倾向于导入.

选项

选项类型默认
sizenumber24
colorstringcurrentColor
durationnumber1
isAnimatedbooleantrue

duration 乘以每个持续时间和延迟,所以 2 以半速演奏. isAnimated: false 转动时转动 startAnimation() 还行 随着运动的减少, 徘徊无所作为 startAnimation() 保持图标的休息.

许可证

麻省理工学院. 图标形状来自Lucide和大图标,见 第三次议会 NoTICES.md。 。 。 .

版本与发布记录

@animateicons/vanilla 共发布 3 个版本,首次发布于 2026/10/17;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.0latest2026/10/2514 天前
0.1.02026/10/1722 天前
0.0.0-stage2026/10/1722 天前

关于 @animateicons/vanilla 的常见问题

@animateicons/vanilla 是什么?

平原JavaScript的动画SVG图标,网络组件和每个框架. 与@animateicons/反应相同,不需要框架.

如何安装 @animateicons/vanilla?

在项目目录运行 npm install @animateicons/vanilla,或使用 pnpm add / yarn add / bun add。

@animateicons/vanilla 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@animateicons/vanilla 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@animateicons/vanilla 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.17.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@animateicons/vanilla 可以商用吗?

@animateicons/vanilla 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@animateicons/vanilla 的下载量有多少?

根据 npm 官方下载统计,@animateicons/vanilla 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,877 次,日均约 63 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@animateicons/vanilla 还在维护吗?

最新版本 0.2.0 发布于 2026/10/25(14 天前);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/10/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。