详细介绍
工具简介
Vivus 是一款专注于 SVG 描边动画的轻量级 JavaScript 类库,由开发者 maxwellito 创建并维护,项目托管于 GitHub 开源平台。它的核心使命非常纯粹:让静态的 SVG 图形“活”起来,呈现出仿佛被一支无形的笔逐笔绘制出来的视觉效果。与市面上许多功能庞杂的动画库不同,Vivus 坚持零依赖的设计哲学,不依赖任何第三方框架(如 jQuery、GSAP 等),自身体积极小,可以轻松嵌入任何 Web 项目中使用。
Vivus 的工作原理基于 SVG 路径的描边(stroke)特性。SVG 中的路径元素(path)可以通过 stroke-dasharray 和 stroke-dashoffset 两个属性控制描边的显示方式。Vivus 正是利用这一机制,通过 JavaScript 动态计算路径长度并逐帧调整描边偏移量,从而模拟出线条被逐渐画出的动画效果。这种基于路径描边的实现方式,使得动画过程非常丝滑流畅,尤其适合线条感强的图形,如 Logo、图标、手绘插画、签名、地图路线等。需要注意的是,SVG 源文件必须保留路径(path)元素,如果图形被转换为轮廓或位图,则无法使用 Vivus 的描边动画能力。
Vivus 提供了多种预设的动画类型,满足不同场景的节奏需求。最基础的是 Delayed 模式:所有路径元素同时开始绘制,但每条路径在启动时带有一个微小的延迟,形成一种错落有致的层次感,这也是当前的默认动画类型。其次是 Sync 模式:每条线同步绘制,所有路径同时开始、同时结束,适合需要整体统一呈现的图形。最引人注目的是 OneByOne 模式:每条路径依次绘制,一条画完再画下一条,这种模式最能营造出“现场手绘”的真实感,是展示 Logo 或插画过程的上佳选择。
除了预设动画类型,Vivus 还赋予开发者极大的自定义自由。它支持覆盖单条路径或整个 SVG 的动画时间函数(timing function),其工作方式类似于 CSS 的动画时间函数,但并非使用 cubic-bezier 曲线,而是采用一个简单的 JavaScript 函数作为钩子。该函数接收一个 0 到 1 之间的数字作为参数,并返回一个同样在 0 到 1 之间的数字,开发者可以借此实现线性、缓入、缓出、弹跳等丰富的缓动效果。官网甚至提供了一个交互式测试面板,让用户直观地调整 Type、Path timing function 和 Anim timing function 等属性,实时预览动画变化。
更具进阶性的是 Scenarize 功能,它允许开发者编写自定义脚本,以任意方式绘制 SVG。具体做法是将自定义的动画数值直接设置在 SVG 的 DOM 中,通过 scenario-sync 等机制精确控制每一段路径的绘制顺序和时机。这为复杂动画编排打开了大门,例如让图形按照特定叙事顺序逐步显现。官网提供了 scenario-sync 的示例,并建议开发者查阅 GitHub 上的源代码和 README 文件以获取更详细的用法。此外,Vivus 还配套了一个名为 Vivus Instant 的在线工具,用户可以直接在浏览器中上传或粘贴 SVG 代码,实时调整参数并预览动画效果,极大降低了上手门槛。
主要功能
多种预设动画类型
Vivus 内置了 Delayed、Sync、OneByOne 三种动画类型。Delayed 让所有路径同时开始但各自带有微小启动延迟,形成错落层次;Sync 让所有路径同步开始与结束,适合整体统一呈现;OneByOne 则逐条绘制路径,最逼真地模拟手绘过程。开发者只需在初始化时指定类型名称即可切换,无需编写额外逻辑。
自定义时间函数
通过传入自定义的 JavaScript 函数,开发者可以覆盖单条路径或整个 SVG 的动画节奏。该函数接收 0 到 1 的进度值并返回 0 到 1 的映射值,实现线性、缓入、缓出、弹跳等缓动效果。这一钩子机制让动画节奏的控制权完全交给开发者,且实现方式比 CSS cubic-bezier 更灵活直观。
场景化脚本(Scenarize)
Scenarize 功能允许开发者编写自定义脚本,将动画数值直接写入 SVG 的 DOM,从而精确编排每一段路径的绘制顺序与时机。这适合需要复杂叙事或分阶段展示的动画场景,例如先画外框再填充细节,或按特定路径顺序引导观众视线。官网提供了 scenario-sync 示例供参考。
零依赖轻量级设计
Vivus 是一个独立的 JavaScript 类,不依赖任何第三方库,文件体积小巧,加载迅速。它可以无缝集成到原生 JavaScript 项目、React、Vue 等现代框架中,不会引入额外的依赖负担,也不会与现有技术栈产生冲突,非常适合对性能敏感的生产环境。
Vivus Instant 在线预览工具
配套的 Vivus Instant 是一个基于浏览器的在线工具,用户可以直接粘贴 SVG 代码或上传文件,实时调整动画类型、时间函数等参数并立即预览效果。它省去了搭建本地环境的步骤,方便设计师和开发者快速试验和调参,确认效果后再将配置应用到实际项目中。
路径级与整体级双重控制
Vivus 允许分别设置单条路径的动画时间函数和整个 SVG 的动画时间函数,实现路径级与整体级的双重节奏控制。这意味着开发者可以让某几条关键线条以弹跳方式出现,而其余线条保持线性绘制,从而在统一动画中制造视觉重点和节奏变化。
使用方法
使用 Vivus 的基本流程如下:
- 引入库文件:通过 script 标签引入 Vivus 的 JavaScript 文件,或通过 npm 等包管理器安装后 import 到项目中。
- 准备 SVG:确保 SVG 图形保留路径(path)元素,且路径具有描边属性。Vivus 依赖路径描边来生成动画,因此图形不能是纯填充轮廓或位图。
- 初始化实例:创建一个 Vivus 实例,传入目标 SVG 元素的选择器或 DOM 节点,并指定动画类型(如 'delayed'、'sync'、'oneByOne')及可选配置项。
- 调整参数:根据需要设置 duration(动画时长)、timing function(时间函数)、delay(延迟)等参数,也可通过 Scenarize 编写自定义脚本。
- 预览与调试:使用 Vivus Instant 在线工具快速预览效果,确认后应用到项目中。
产品优势
Vivus 的核心优势在于专一而精。它不试图成为全能动画框架,而是把 SVG 描边动画这一件事做到极致。零依赖和轻量级设计使其对项目侵入性极低;三种预设动画覆盖了大多数常见需求;自定义时间函数和 Scenarize 脚本则为高级用户保留了充分的创作空间。此外,开源免费、文档清晰、配套在线工具完善,使得学习和使用成本都很低。对于需要展示 Logo 绘制过程、图标动态呈现、手绘风格插画或路线动画的 Web 项目而言,Vivus 是一个高效且优雅的解决方案。
应用场景
- 品牌 Logo 展示:在网站首屏或加载页用 OneByOne 模式逐笔绘制 Logo,强化品牌记忆点。
- 图标与插画动效:为线性图标、手绘插画添加描边动画,提升界面的精致感和互动趣味。
- 数据可视化引导:在地图路线、流程图、连接线等场景中,用描边动画引导用户视线沿路径移动。
- 教学与演示:在教程或演示页面中动态绘制图形步骤,帮助观众理解绘制过程或结构关系。
- 加载与过渡动画:用轻量的 SVG 描边动画作为页面加载指示或场景过渡效果,兼顾美观与性能。


