Vivus

Vivus

免费Web
访问官网

Vivus是一款轻量级无依赖的JavaScript库,能让SVG路径呈现被逐笔绘制的动画效果,支持多种动画类型与自定义脚本。

Vivus访问官网

详细介绍

工具简介

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 的基本流程如下:

  1. 引入库文件:通过 script 标签引入 Vivus 的 JavaScript 文件,或通过 npm 等包管理器安装后 import 到项目中。
  2. 准备 SVG:确保 SVG 图形保留路径(path)元素,且路径具有描边属性。Vivus 依赖路径描边来生成动画,因此图形不能是纯填充轮廓或位图。
  3. 初始化实例:创建一个 Vivus 实例,传入目标 SVG 元素的选择器或 DOM 节点,并指定动画类型(如 'delayed'、'sync'、'oneByOne')及可选配置项。
  4. 调整参数:根据需要设置 duration(动画时长)、timing function(时间函数)、delay(延迟)等参数,也可通过 Scenarize 编写自定义脚本。
  5. 预览与调试:使用 Vivus Instant 在线工具快速预览效果,确认后应用到项目中。


产品优势

Vivus 的核心优势在于专一而精。它不试图成为全能动画框架,而是把 SVG 描边动画这一件事做到极致。零依赖和轻量级设计使其对项目侵入性极低;三种预设动画覆盖了大多数常见需求;自定义时间函数和 Scenarize 脚本则为高级用户保留了充分的创作空间。此外,开源免费、文档清晰、配套在线工具完善,使得学习和使用成本都很低。对于需要展示 Logo 绘制过程、图标动态呈现、手绘风格插画或路线动画的 Web 项目而言,Vivus 是一个高效且优雅的解决方案。


应用场景

  • 品牌 Logo 展示:在网站首屏或加载页用 OneByOne 模式逐笔绘制 Logo,强化品牌记忆点。
  • 图标与插画动效:为线性图标、手绘插画添加描边动画,提升界面的精致感和互动趣味。
  • 数据可视化引导:在地图路线、流程图、连接线等场景中,用描边动画引导用户视线沿路径移动。
  • 教学与演示:在教程或演示页面中动态绘制图形步骤,帮助观众理解绘制过程或结构关系。
  • 加载与过渡动画:用轻量的 SVG 描边动画作为页面加载指示或场景过渡效果,兼顾美观与性能。

核心功能

1
Delayed 延迟动画
所有路径元素同时开始绘制,但每条路径在启动时带有微小延迟,形成错落有致的层次感。这是 Vivus 的默认动画类型,适合需要整体协调又略带节奏变化的图形展示。
2
Sync 同步动画
每条路径同步开始、同时结束,所有线条在同一时间窗口内完成绘制。适合需要整体统一呈现的图形,如对称图标或结构规整的几何图形,视觉上干净利落。
3
OneByOne 逐条动画
每条路径依次绘制,一条画完再画下一条,最逼真地模拟现场手绘过程。这是展示 Logo、插画或签名等图形绘制过程的理想选择,能营造强烈的叙事感和期待感。
4
自定义时间函数
通过传入 JavaScript 函数覆盖单条路径或整个 SVG 的动画节奏,函数接收 0 到 1 的进度值并返回映射值,可实现线性、缓入、缓出、弹跳等缓动效果,控制粒度比 CSS 更灵活。
5
Scenarize 场景化脚本
允许开发者编写自定义脚本,将动画数值直接写入 SVG 的 DOM,精确编排每一段路径的绘制顺序与时机。适合复杂叙事动画,如先画外框再填充细节或按特定路径顺序引导视线。
6
零依赖轻量集成
作为独立的 JavaScript 类,不依赖任何第三方库,文件体积小巧,可无缝集成到原生 JS、React、Vue 等项目中,不增加额外依赖负担,适合对性能敏感的生产环境。
7
Vivus Instant 在线预览
配套的浏览器在线工具,支持粘贴或上传 SVG 代码,实时调整动画类型与时间函数并立即预览效果,省去本地搭建环境的步骤,方便快速试验和调参。
8
路径级与整体级双重控制
可分别设置单条路径和整个 SVG 的动画时间函数,实现双重节奏控制。例如让关键线条以弹跳方式出现,其余线条保持线性绘制,在统一动画中制造视觉重点。

优缺点分析

优点
+专一而精:专注 SVG 描边动画,三种预设类型覆盖常见需求,自定义函数和 Scenarize 脚本保留充分创作空间。
+零依赖轻量:不依赖任何第三方库,体积小巧,对项目侵入性极低,可无缝集成到各种技术栈中。
+开源免费且文档清晰:项目托管于 GitHub 开源,配套 Vivus Instant 在线工具降低上手门槛,学习和使用成本低。
+动画丝滑流畅:基于路径描边机制实现,逐帧调整描边偏移量,线条绘制过程自然顺滑,尤其适合线性图形。
缺点
-仅支持 SVG 路径描边动画:要求 SVG 源文件保留 path 元素,纯填充轮廓或位图无法使用,适用图形类型受限。
-高级功能需编写代码:Scenarize 自定义脚本和自定义时间函数需要一定的 JavaScript 基础,对纯设计师不够友好。
-缺乏官方中文文档:目前文档以英文为主,中文开发者需要借助翻译或社区资料学习。

适用人群

前端开发者:需要在 Web 项目中为 SVG 图形添加描边绘制动画,追求轻量、无依赖的解决方案。UI/UX 设计师:希望为 Logo、图标、插画等线性图形设计动态呈现效果,提升界面精致度与互动趣味。品牌与营销人员:需要在网站首屏、加载页或活动页面用 Logo 逐笔绘制动画强化品牌记忆点。数据可视化开发者:需要在地图路线、流程图、连接线等场景中用描边动画引导用户视线沿路径移动。教学与演示内容创作者:需要在教程或演示页面中动态绘制图形步骤,帮助观众理解绘制过程或结构关系。

常见问题

Q: Vivus 支持哪些动画类型?如何选择?
Vivus 内置 Delayed、Sync、OneByOne 三种动画类型。Delayed 让所有路径同时开始但各自带微小启动延迟,形成错落层次,是默认类型;Sync 让所有路径同步开始与结束,适合整体统一呈现;OneByOne 逐条绘制路径,最逼真地模拟手绘过程。选择时可根据图形特点和展示意图决定:需要整体协调选 Delayed 或 Sync,需要叙事感和过程展示选 OneByOne。
Q: 使用 Vivus 对 SVG 文件有什么要求?
Vivus 的动画基于 SVG 路径的描边(stroke)特性,因此 SVG 源文件必须保留路径(path)元素,且路径应具有描边属性。如果图形被转换为轮廓、合并为单一填充形状或导出为位图,则无法使用 Vivus 的描边动画能力。建议在设计工具中导出 SVG 时保留路径和描边信息,避免执行“轮廓化描边”或“合并形状”等破坏路径结构的操作。
Q: Vivus 是否需要依赖其他库?如何集成到项目中?
Vivus 是一个零依赖的独立 JavaScript 类,不需要 jQuery、GSAP 等任何第三方库。集成方式很简单:可以通过 script 标签直接引入库文件,也可以通过 npm 等包管理器安装后 import 到项目中。初始化时传入目标 SVG 元素的选择器或 DOM 节点,并指定动画类型和可选配置即可。它可无缝用于原生 JavaScript 项目以及 React、Vue 等现代框架。
Q: 什么是 Scenarize 功能?适合什么场景?
Scenarize 是 Vivus 的高级功能,允许开发者编写自定义脚本,将动画数值直接设置在 SVG 的 DOM 中,从而精确编排每一段路径的绘制顺序和时机。它适合需要复杂叙事或分阶段展示的动画场景,例如先画外框再填充细节,或按特定路径顺序引导观众视线。官网提供了 scenario-sync 示例,建议查阅 GitHub 上的源代码和 README 文件了解详细用法。
Q: Vivus 可以免费使用吗?
是的,Vivus 是开源项目,托管于 GitHub 平台,采用开源许可免费提供使用。开发者可以自由地将其集成到个人或商业项目中,无需支付授权费用。具体许可条款建议查阅 GitHub 仓库中的 LICENSE 文件。配套的 Vivus Instant 在线预览工具也可免费使用,方便快速试验动画效果。