jQuery Circle Progress 动态更新值并实现平滑动画过渡

DDD
发布: 2025-10-07 14:42:57
原创
863人浏览过

jQuery Circle Progress 动态更新值并实现平滑动画过渡

本文详细介绍了在使用 jquery-circle-progress 插件时,如何解决更新进度值导致动画从0重新开始的问题。通过采用插件提供的特定方法签名 circleProgress('value', newValue),可以实现进度条从当前值平滑过渡到新值的动画效果,避免不必要的动画重置,从而提升用户体验。

理解问题:动画重置的根源

在使用 jquery-circle-progress 插件时,开发者常会遇到一个问题:当需要动态更新进度条的值时,如果直接通过传递一个包含新值的配置对象(例如 $(".element").circleprogress({ value: newvalue });)来更新,进度条的动画会从0开始重新绘制,而不是从当前显示的值平滑过渡到新值。这种行为通常是由于插件将此操作视为对组件的重新初始化,从而导致动画效果不连贯,影响用户体验。用户期望的是,当数据更新时,进度条能够智能地识别当前状态,并从该状态开始,以动画形式过渡到新的目标值。

核心解决方案:使用 circleProgress('value', newValue) 方法

jquery-circle-progress 插件为了解决动态更新值的平滑过渡问题,提供了一个专门的方法签名。要实现从当前值到新值的无缝动画,应使用字符串 'value' 作为第一个参数,后跟新的数值(0到1之间)作为第二个参数来调用 circleProgress 方法。

例如,将 $(".element").circleProgress({ value: 0.80 }); 更改为 $(".element").circleProgress('value', 0.80);。

这种调用方式会指示插件更新其内部的 value 属性,并触发一个从当前绘制进度到新目标值的动画,而不是重新初始化整个组件。这是实现平滑、连续动画的关键。

代码示例与实践

下面将通过一个完整的示例来演示如何正确地初始化和动态更新 jquery-circle-progress 进度条,以实现平滑的动画过渡。

HTML 结构

首先,我们需要一个基本的 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 样式

为了使进度条具有良好的视觉效果,我们需要一些基础的 CSS 样式。

萌动AI
萌动AI

CreateAI旗下AI动漫视频生成平台

萌动AI 438
查看详情 萌动AI
@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%;
  }
}
登录后复制

JavaScript 实现

这是核心部分,展示了如何初始化进度条以及如何动态更新其值以实现平滑动画。

$(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 事件监听器用于在动画进行时实时更新进度条内部的文本显示,确保用户能看到精确的当前进度。

重要注意事项

  1. 值范围: circleProgress 方法的 value 参数必须是一个介于 0 到 1 之间的浮点数,代表百分比(例如,0.5 表示 50%)。
  2. 动画平滑性: 始终使用 circleProgress('value', newValue) 的方法签名来动态更新进度条的值,以确保动画从当前值平滑过渡,而非从0重新开始。
  3. 文档查阅: 对于更复杂的配置或高级功能,建议查阅 jquery-circle-progress 插件的官方文档(通常在 GitHub 页面或其示例页面)。
  4. 文本精度: 在 circle-animation-progress 事件中更新显示的百分比文本时,使用 toFixed() 方法可以控制小数点后的位数,提高显示的可读性。例如 (stepValue * 100).toFixed(1) 表示保留一位小数。

总结

通过本文的详细教程,我们了解了在使用 jquery-circle-progress 插件时,如何避免因不当更新导致动画重置的问题。核心在于正确利用插件提供的 circleProgress('value', newValue) 方法签名,这使得进度条能够从其当前状态平滑过渡到新的目标值,极大地提升了用户界面的动态性和用户体验。遵循这些最佳实践,可以确保你的进度条动画效果既专业又流畅。

以上就是jQuery Circle Progress 动态更新值并实现平滑动画过渡的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号