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

DDD

发布时间：2025-10-07 14:42:57

875人浏览过

来源于php中文网

原创

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 样式。

AssemblyAI

转录和理解语音的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 事件监听器用于在动画进行时实时更新进度条内部的文本显示，确保用户能看到精确的当前进度。

重要注意事项

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

总结

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

如何防止表格行（tr）和单元格（td）因内容自动撑高？

如何正确为嵌套元素单独移除 CSS 模糊滤镜

如何让 CSS 边框严格限制在元素设定宽度内（避免溢出）

精确计算元素在滚动过程中首次可见与完全消失的 scrollTop 值

计算元素在滚动过程中首次可见与完全消失时的 scrollTop 值