SVG路径动画核心是用getTotalLength()获精确长度,设stroke-dasharray为“len len”、初始stroke-dashoffset为len实现隐藏,再通过CSS过渡将其归零完成绘制。

用 stroke-dashoffset 做 SVG 路径动画,核心是“先算总长,再反向偏移,最后用 CSS 过渡或动画驱动偏移量变化”。关键不在属性本身,而在如何配合 stroke-dasharray 一起控制“虚线显示范围”。
1. 先获取路径的精确总长度
不能靠目测或估算。必须用 JavaScript 的 getTotalLength() 方法获取真实路径长度(单位是用户坐标,和 SVG viewBox 一致):
const path = document.querySelector('path');
const len = path.getTotalLength(); // 比如返回 248.37
这个值要记下来,后续动画全程依赖它。
2. 设置 stroke-dasharray 和初始 stroke-dashoffset
让路径“从不可见变成可见”,常用做法是:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- 设
stroke-dasharray为len len(即“实线长 = 总长,间隙长 = 总长”) - 初始
stroke-dashoffset设为len:此时整条虚线被向右推了整整一倍长度,起点完全移出视野,路径看起来是隐藏的 - 动画终点设
stroke-dashoffset为0:虚线归位,路径完整显示
示例 CSS:
path {
stroke-dasharray: 248.37 248.37;
stroke-dashoffset: 248.37;
transition: stroke-dashoffset 0.8s ease-in-out;
}
path.draw {
stroke-dashoffset: 0;
}
3. 触发动画的几种实用方式
常见触发场景及写法:
- 页面加载后自动播放:JS 中加 class 或直接设置 style
-
滚动进入视区时播放:用
IntersectionObserver监听,进入后添加.draw类 - 点击按钮触发:绑定 click 事件,切换 class 即可(支持反复播放)
注意:如果想重播动画,需先重置 stroke-dashoffset 到 len,再强制重排(例如用 offsetWidth 或 setTimeout(..., 0)),再设回 0。
4. 小心这些坑
-
路径含 transform 或缩放:
getTotalLength()返回的是原始路径长度,不受 CSS 缩放影响;但若用了transform: scale(),视觉长度变了,动画速度会失真——建议避免对<path></path>直接缩放,改用viewBox或容器缩放 -
描边宽度很大时:动画本身不控制粗细,只控制“画到哪”,所以粗描边的起始边缘可能略显突兀,可通过
stroke-linecap: round或stroke-linejoin: round改善观感 -
IE 不支持 transition on dashoffset:如需兼容 IE,得用
requestAnimationFrame手动更新 offset 值


















