
在使用 jquery-circle-progress 插件时,开发者常会遇到一个问题:当需要动态更新进度条的值时,如果直接通过传递一个包含新值的配置对象(例如 $(".element").circleprogress({ value: newvalue });)来更新,进度条的动画会从0开始重新绘制,而不是从当前显示的值平滑过渡到新值。这种行为通常是由于插件将此操作视为对组件的重新初始化,从而导致动画效果不连贯,影响用户体验。用户期望的是,当数据更新时,进度条能够智能地识别当前状态,并从该状态开始,以动画形式过渡到新的目标值。
jquery-circle-progress 插件为了解决动态更新值的平滑过渡问题,提供了一个专门的方法签名。要实现从当前值到新值的无缝动画,应使用字符串 'value' 作为第一个参数,后跟新的数值(0到1之间)作为第二个参数来调用 circleProgress 方法。
例如,将 $(".element").circleProgress({ value: 0.80 }); 更改为 $(".element").circleProgress('value', 0.80);。
这种调用方式会指示插件更新其内部的 value 属性,并触发一个从当前绘制进度到新目标值的动画,而不是重新初始化整个组件。这是实现平滑、连续动画的关键。
下面将通过一个完整的示例来演示如何正确地初始化和动态更新 jquery-circle-progress 进度条,以实现平滑的动画过渡。
首先,我们需要一个基本的 HTML 结构来承载进度条和触发更新的按钮。
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-circle-progress/1.2.2/circle-progress.min.js"></script>
<div class="wrapper">
<div class="card react">
<div class="circle">
<div class="bar"></div>
<div class="box"><span></span></div>
</div>
<div class="text">React JS</div>
</div>
</div>
<button id="add">更新进度</button>为了使进度条具有良好的视觉效果,我们需要一些基础的 CSS 样式。
@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@200;300;400;500;600;700&display=swap');
*{
margin: 0;
padding: 0;
box-sizing: border-box;
font-family: 'Poppins', sans-serif;
}
body{
display: flex;
flex-direction: column; /* 调整为列布局以容纳按钮 */
align-items: center;
justify-content: center;
min-height: 100vh;
padding: 20px;
background: -webkit-linear-gradient(left, #53c68a, #8b67c4);
}
.wrapper{
width: 1000px;
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: space-between;
margin-bottom: 20px; /* 添加底部外边距,与按钮分离 */
}
.wrapper .card{
background: #fff;
width: calc(25% - 8px);
height: 300px;
border-radius: 5px;
display: flex;
align-items: center;
justify-content: space-evenly;
flex-direction: column;
box-shadow: 0px 10px 15px rgba(0,0,0,0.1);
}
.wrapper .card .circle{
position: relative;
height: 150px;
width: 150px;
border-radius: 50%;
cursor: default;
}
.card .circle .box,
.card .circle .box span{
position: absolute;
top: 50%;
left: 50%;
}
.card .circle .box{
height: 100%;
width: 100%;
background: #fff;
border-radius: 50%;
transform: translate(-50%, -50%) scale(0.8);
transition: all 0.2s;
}
.card .circle:hover .box{
transform: translate(-50%, -50%) scale(0.91);
}
.card .circle .box span,
.wrapper .card .text{
background: -webkit-linear-gradient(left, #a445b2, #fa4299);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
}
.circle .box span{
font-size: 38px;
font-family: sans-serif;
font-weight: 600;
transform: translate(-45%, -45%);
transition: all 0.1s;
}
.card .circle:hover .box span{
transform: translate(-45%, -45%) scale(1.09);
}
.card .text{
font-size: 20px;
font-weight: 600;
}
#add {
padding: 10px 20px;
font-size: 16px;
cursor: pointer;
background-color: #fa4299;
color: white;
border: none;
border-radius: 5px;
transition: background-color 0.3s ease;
}
#add:hover {
background-color: #a445b2;
}
@media(max-width: 753px){
.wrapper{
max-width: 700px;
}
.wrapper .card{
width: calc(50% - 20px);
margin-bottom: 20px;
}
}
@media(max-width: 505px){
.wrapper{
max-width: 500px;
}
.wrapper .card{
width: 100%;
}
}这是核心部分,展示了如何初始化进度条以及如何动态更新其值以实现平滑动画。
$(document).ready(function() {
// 定义通用选项,例如起始角度、大小和填充颜色
let commonOptions = {
startAngle: -1.55, // 约-90度,从顶部开始
size: 150,
fill: { gradient: ['#a445b2', '#fa4299'] }
};
// 初始化第一个(或所有)需要显示文本的进度条
// 这里以 .circle .bar 为例,如果你的页面中有多个,可以根据需要调整选择器
// 注意:此处示例代码中只展示了对 .react .bar 的操作,
// 但如果你的 .circle .bar 也有初始值和文本显示,可以这样设置:
$(".circle .bar").circleProgress(commonOptions).on('circle-animation-progress',
function(event, progress, stepValue) {
// 设置文本显示精度
let precision = 1; // 小数点后1位
let num = (stepValue * 100).toFixed(precision);
$(this).parent().find("span").text(String(num) + "%");
});
// 初始化 .react .bar 进度条的初始值
// 同样使用 'value', newValue 的形式,即使是第一次设置
$(".react .bar").circleProgress(commonOptions); // 先应用通用设置
$(".react .bar").circleProgress('value', 0.60); // 再设置初始值
// 为按钮添加点击事件监听器,动态更新进度条
$('#add').on('click', function() {
// 使用 'value', newValue 的方法签名来平滑更新进度条
$(".react .bar").circleProgress('value', 0.802); // 更新到新的值
});
});在这个 JavaScript 代码中,我们首先定义了一组 commonOptions。然后,我们对 .react .bar 元素进行了初始化,先应用了通用选项,接着使用 circleProgress('value', 0.60) 设置了其初始值。
最关键的部分在于 $('#add').on('click', function() { ... }); 事件处理函数中。当点击“更新进度”按钮时,我们调用 $(".react .bar").circleProgress('value', 0.802);。请注意,这里不再传递一个完整的配置对象,而是直接传递字符串 'value' 和新的目标值 0.802。这样,jquery-circle-progress 插件就会从当前显示的进度值开始,平滑地动画到 0.802,而不是从0重新开始。
circle-animation-progress 事件监听器用于在动画进行时实时更新进度条内部的文本显示,确保用户能看到精确的当前进度。
通过本文的详细教程,我们了解了在使用 jquery-circle-progress 插件时,如何避免因不当更新导致动画重置的问题。核心在于正确利用插件提供的 circleProgress('value', newValue) 方法签名,这使得进度条能够从其当前状态平滑过渡到新的目标值,极大地提升了用户界面的动态性和用户体验。遵循这些最佳实践,可以确保你的进度条动画效果既专业又流畅。
以上就是jQuery Circle Progress 动态更新值并实现平滑动画过渡的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号