使用D3.js实现带有弹性动画效果的动态SVG仪表盘
本文详解如何利用D3.js构建一个简洁且具备动态效果的SVG仪表盘。通过定义圆弧角度、添加CSS样式及指针标记,实现数值变化的渐变过程。重点解析如何使用transition和attrTween实现圆弧与指针的弹性回弹动画,解决Echarts无法满足的定制化需求,提供完整的代码实现思路。
D3.js动态仪表盘实现概述
本文阐述了基于D3.js构建简洁且实用的动态仪表盘的实现方案,供参考。
动态效果展示:

仪表盘视觉呈现
观察上述动态效果,可见:
- 数值从旧值过渡至新值时,呈现渐变过程;
- 圆弧末端设有竖线作为指针,数值变化时伴随弹性动画。
起初尝试使用Echarts实现仪表盘,但因其无法满足前述两点需求,故转而采用D3.js。
D3.js支持图表的高度定制化,能从细节层面完美契合需求。
静态仪表盘初始化步骤
仪表盘初始化流程
1、首先定义一个svg元素:
<svg id="myGauge" width="80" height="108" ></svg>
随后,声明若干变量以完成初始化:
var width=80,
height=108, //svg的高度和宽度,也可以通过svg的width、height属性获取
innerRadius = 22,
outerRadius = 30, //圆弧的内外半径
arcMin = -Math.PI*2/3,
arcMax = Math.PI*2/3, //圆弧的起始角度和终止角度
2、构建arc方法并配置所有属性,唯独排除endAngle。创建圆弧时,向该方法传入含endAngle属性的对象,即可计算出对应角度的SVG path。
var arc = d3.arc()
.innerRadius(22)
.outerRadius(30)
.startAngle(arcMin)
圆弧角度如何设定?
将圆形映射为时钟,12点钟方向对应角度0,顺时针3点钟方向为Math.PI/2,逆时针6点钟方向为-Math.PI。因此,-Math.PI*2/3至Math.PI*2/3的圆弧形状如上图所示。更多细节可参阅API文档中的arc.startAngle。
3、获取SVG元素,并将原点平移至画布中心,从而在后续创建圆弧时无需单独指定位置。
var svg = d3.select("#myGauge")
var g = svg.append("g").attr("transform", "translate(" + width / 2 + "," + height / 2 + ")");
4、添加仪表盘中的文字(标题,数值,单位)
//添加仪表盘的标题
g.append("text").attr("class", "gauge-title")
.style("alignment-baseline", "central") //相对父元素对齐方式
.style("text-anchor", "middle") //文本锚点,居中
.attr("y", -45) //到中心的距离
.text("CPU占用率");
//添加仪表盘显示的数值,因为之后还要更新,所以声明一个变量
var valueLabel = g.append("text").attr("class", "gauge-value")
.style("alignment-baseline", "central") //相对父元素对齐方式
.style("text-anchor", "middle") //文本锚点,居中
.attr("y", 25) //到中心的距离
.text(12.65);
//添加仪表盘显示数值的单位
g.append("text").attr("class", "gauge-unity")
.style("alignment-baseline", "central") //相对父元素对齐方式
.style("text-anchor", "middle") //文本锚点,居中
.attr("y", 40) //到中心的距离
.text("%");
D3生成的SVG图形相较于Echarts绘制的Canvas,一大优势在于可利用CSS定义SVG样式。例如,此处仪表盘标题的样式定义如下:
.gauge-title{
font-size: 10px;
fill: #A1A6AD;
}
5、添加背景圆弧
//添加背景圆弧
var background = g.append("path")
.datum({endAngle:arcMax}) //传递endAngle参数到arc方法
.style("fill", "#444851")
.attr("d", arc);
6、添加表示百分比的圆弧,其中percentage为需表示的百分比,取值范围为0到1的小数。
//计算圆弧的结束角度
var currentAngle = percentage*(arcMax-arcMin) + arcMin
//添加另一层圆弧,用于表示百分比
var foreground = g.append("path")
.datum({endAngle:currentAngle})
.style("fill", "#444851")
.attr("d", arc);
7、在圆弧末尾添加指针标记
var tick = g.append("line")
.attr('class', 'gauge-tick')
.attr("x1", 0)
.attr("y1", -innerRadius)
.attr("x2", 0)
.attr("y2", -(innerRadius + 12)) //定义line位置,默认是在圆弧正中间,12是指针的长度
.style("stroke", "#A1A6AD")
.attr('transform', 'rotate('+ angleToDegree(currentAngle) +')')
rotate参数单位为度,Math.PI对应180度,因此需自定义angleToDegree方法以转换currentAngle。
至此,SVG仪表盘制作完成,但当前为静态,如何更新该仪表盘?
动态更新与弹性动画实现
仪表盘更新机制
需更新内容:表示新百分比的圆弧;圆弧下方的数值。
修改圆弧下方数值十分简便:
valueLabel.text(newValue)
更新圆弧稍显复杂,具体思路为:修改圆弧的endAngle,以及调整圆弧末尾指针的transform值。
实现过程中需调用的API:
selection.transition:https://github.com/d3/d3-transition/blob/master/README.md#selection_transition transition.attrTween:https://github.com/d3/d3-transition/blob/master/README.md#transition_attrTween d3.interpolate:https://github.com/d3/d3-interpolate/blob/master/README.md#interpolate
1、更新圆弧,其中angle为新圆弧的结束角度。
//更新圆弧,并且设置渐变动效
foreground.transition()
.duration(750)
.ease(d3.easeElastic) //设置来回弹动的效果
.attrTween("d", arcTween(angle));
arcTween方法定义如下。它返回一个d属性的补间(渐变)动画方法,使圆弧从当前角度平滑过渡至新角度。
arcTween(newAngle) {
let self=this
return function(d) {
var interpolate = d3.interpolate(d.endAngle, newAngle); //在两个值间找一个插值
return function(t) {
d.endAngle = interpolate(t); //根据 transition 的时间 t 计算插值并赋值给endAngle
return arc(d); //返回新的“d”属性值
};
};
}
该方法更详细的说明可参考Arc Tween中的注释。
2、更新圆弧末尾指针的原理同上,其中oldAngle为旧圆弧的结束角度。
//更新圆弧末端的指针标记,并且设置渐变动效
tick.transition()
.duration(750)
.ease(d3.easeElastic) //设置来回弹动的效果
.attrTween('transform', function(){ //设置“transform”属性的渐变,原理同上面的arcTween方法
var i = d3.interpolate(angleToDegree(oldAngle), angleToDegree(newAngle)); //取插值
return function(t) {
return 'rotate('+ i(t) +')'
};
})
至此,我们成功制作了一个动态刷新、简洁美观的SVG仪表盘。
结语
每次使用D3.js都令人惊叹于其强大与趣味~它宛如百宝箱,助我们最大程度地满足各类需求。
以上为本文全部内容,希望对各位的学习有所助益,也欢迎大家多多支持本站。
JS怎么使用classList添加、删除和切换class
2026-11-05 17:26:02
网页开发三者分工:HTML结构、CSS样式与JavaScript交互怎么协作
2026-11-05 12:51:22
JS解析URL参数时怎么处理中文乱码和特殊字符
2026-11-05 12:47:23
js-cookie 存储 JSON 对象:自动序列化与反序列化技巧
2026-11-05 12:36:26
marked.js 快速上手:安装与基础 Markdown 转 HTML 示例
2026-11-05 09:32:53
