JS数字滚动时怎么实时添加千分位分隔符

作者:寒星

时间:2026-11-17

浏览:241

深入讲解在JavaScript中实现平滑数字滚动动画时如何实时添加千分位分隔符。涵盖requestAnimationFrame帧循环、缓动函数计算、单例Intl.NumberFormat与正则格式化对比、CSS等宽数字防抖及完整生产级代码封装。

文章目录
在 JavaScript 中实现数字平滑滚动且实时展示千分位分隔符,核心在于解耦数值插值与文本渲染:在 requestAnimationFrame 驱动的逐帧动画循环中,持续根据已消耗的时间比例计算出当前瞬间的原始数值,随后通过预先创建的 Intl.NumberFormat 格式化单例(或轻量正则)将其瞬时转换为带逗号的千分位字符串,最后写入 DOM 节点的 textContent。切勿在已经带有逗号的字符串上直接做数值增减。
JS数字滚动时怎么实时添加千分位分隔符
展示图:数字滚动动画中由原始数值到千分位格式化视图的实时呈现过程

一、核心认知:插值的是数值,呈现的是视图

初次在业务中开发类似电商成交额、大屏看板或仪表盘的数字翻滚动效时,容易出现一个典型误区:试图直接通过字符串替换去操作页面上已经包含逗号的内容。数字“滚动”的实质是在固定的时间内(如 2000 毫秒),数值从起始点(如 0)按特定的速率曲线平滑递增至目标点(如 1,289,450)。

在这个数学演进过程中,每一帧所计算出的都是纯正的浮点数或整数(例如第 45 帧时为 842319.42)。千分位逗号只是一层“视觉滤镜”——我们在把这个数丢给页面显示之前,实时调用格式化函数将其变成 "842,319"。只有保持这样的单向数据流,才能保证数字累加的严谨性与平滑度。

JS数字滚动时怎么实时添加千分位分隔符
图 1:数字滚动与实时千分位渲染流水线(时间步进、缓动变换、格式化与 DOM 写入)

二、构建平滑动画骨架:requestAnimationFrame 与缓动算法

实现数字滚动的计时器不应使用 setInterval 或 setTimeout。由于浏览器刷新率(通常为 60Hz 或 120Hz)和宏任务队列机制,定时器容易产生帧抖动与跳跃感。标准做法是使用 requestAnimationFrame(简称 rAF),它能让每一帧的计算与浏览器屏幕硬件刷新同频。

为了让数字看起来自然顺畅,通常不会使用生硬的匀速线性增加,而是采用先快后慢的减速曲线(如三次缓出 easeOutCubic)。人眼对前半程的高速数字跳动感知敏锐,而后半程平缓停靠在最终数字上,能带来极佳的视觉质感。

缓动公式非常简洁。如果设动画归一化进度为 p(范围 0 到 1),经典的三次减速函数为:

// 缓出公式:输入当前时间比例 [0, 1],输出经过缓动调整的进度 [0, 1]
function easeOutCubic(t) {
  return 1 - Math.pow(1 - t, 3);
}
关键依据:requestAnimationFrame 回调函数会默认传入一个高精度时间戳参数 timestamp(自页面加载起经过的毫秒数)。每一帧的已用时间必须由 timestamp - startTime 计算得出,绝不要在循环体内调用 Date.now() 或 performance.now() 另起炉灶,以防微观时间偏差。

三、高性能逐帧格式化:Intl.NumberFormat 单例与正则

数字动画在 1 到 2 秒内往往会执行 60 到 240 次回调。如果每跑一帧就执行一次开销巨大的操作,不仅会导致页面掉帧(卡在某几个数字),还会频繁触发 V8 引擎的垃圾回收(GC),造成偶发性微卡顿。

1. 最优实践:预实例化的 Intl.NumberFormat(单例)

现代 JavaScript 原生提供了强大的国际化数字格式化工具 Intl.NumberFormat。它的底层由浏览器原生 C++ 核心支持,具备极高格式化效率,并能精确处理负数、小数位数及多语言分隔符。

// 正确做法:在动画启动前创建好实例,复用该单例
const numberFormatter = new Intl.NumberFormat('en-US');

// 在每一帧内直接复用单例的 format 方法:
const formattedText = numberFormatter.format(Math.floor(currentValue));
避坑警示:严禁在 rAF 循环内 new Intl.NumberFormat!
new Intl.NumberFormat() 的构造过程需要读取并解析本地化语言环境、初始化模式字典,其开销比单纯的数字格式化高出数千倍。若在逐帧循环中重复 new,每一帧都会产生几十微秒的垃圾对象,直接造成肉眼可见的卡顿。

2. 轻量备选:纯整数场景的正向预查正则

如果滚动对象确定为纯正整数,且不希望依赖任何外部实例,可以使用纯正则断言进行匹配替换。这种方式无额外引用开销,单帧耗时极短:

// 正则千分位替换纯整数
function formatInteger(num) {
  return Math.floor(num).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
}
JS数字滚动时怎么实时添加千分位分隔符
图 2:数字滚动实时千分位格式化执行流程与状态转换时序

四、完整生产级代码封装

将上述的时间管理、三次缓动插值、单例千分位格式化以及二次触发时的中断清理(cancelAnimationFrame)组合在一起,即可得到一个健壮、开箱即用的数字滚动格式化函数:

/**
 * 数字滚动并实时添加千分位分隔符
 * @param {HTMLElement} element 需要展示数字的 DOM 元素
 * @param {number} targetValue 目标终值
 * @param {object} options 配置项(动画时长、初始值、小数位数等)
 */
function animateNumberWithCommas(element, targetValue, options = {}) {
  const {
    duration = 1800,        // 动画持续时间(毫秒)
    startValue = 0,         // 起始数字
    decimals = 0,           // 保留小数位数
    easing = (t) => 1 - Math.pow(1 - t, 3) // 默认 easeOutCubic 缓动
  } = options;

  // 1. 若当前元素正处于滚动动画中,先取消前一次动画,防止竞争重叠
  if (element._animFrameId) {
    cancelAnimationFrame(element._animFrameId);
  }

  // 2. 预先创建单例格式化器,设置小数约束
  const formatter = new Intl.NumberFormat('en-US', {
    minimumFractionDigits: decimals,
    maximumFractionDigits: decimals
  });

  let startTime = null;
  const valueChange = targetValue - startValue;

  // 3. 逐帧步进回调
  function step(timestamp) {
    if (!startTime) startTime = timestamp;

    // 计算当前线性时间进度 (0 ~ 1)
    const elapsed = timestamp - startTime;
    const progress = Math.min(elapsed / duration, 1);

    // 经缓动变换后的进度
    const easedProgress = easing(progress);

    // 当前瞬间计算出来的纯数值
    const currentVal = startValue + valueChange * easedProgress;

    // 实时格式化并更新到 DOM
    // 当存在小数位时保持浮点,纯整型时向下取整或四舍五入
    const roundedVal = decimals > 0 
      ? Number(currentVal.toFixed(decimals)) 
      : Math.round(currentVal);

    element.textContent = formatter.format(roundedVal);

    // 4. 判定是否达到终点
    if (progress < 1) {
      element._animFrameId = requestAnimationFrame(step);
    } else {
      // 动画完成:使用目标确切终值进行最后一次强制兜底,避免浮点积累误差
      element.textContent = formatter.format(targetValue);
      element._animFrameId = null;
    }
  }

  // 启动第一帧
  element._animFrameId = requestAnimationFrame(step);
}

HTML 与使用示例

<!-- 页面节点 -->
<div id="counter" style="font-size: 32px; font-weight: bold;">0</div>

<script>
  const counterEl = document.getElementById('counter');

  // 从 0 滚动到 2,854,920,时长 2 秒
  animateNumberWithCommas(counterEl, 2854920, {
    duration: 2000,
    decimals: 0
  });

  // 金额场景:支持小数位,滚动至 125,480.50
  // animateNumberWithCommas(counterEl, 125480.50, { duration: 1500, decimals: 2 });
</script>
JS数字滚动时怎么实时添加千分位分隔符
图 3:逐帧格式化方案(单例 Intl、每帧 new Intl、正则、toLocaleString)性能与特性对比

五、生产环境关键细节:排坑与体验提升

1. 根治文字水平抖动:CSS tabular-nums

在数字滚动过程中,许多开发者会发现一个常见瑕疵:虽然数字变化很流畅,但数字所在的容器或周围的文字在剧烈左右颤抖。

这是因为在绝大部分中西文字体(如 Arial、PingFang SC、Helvetica)中,数字默认是比例字体(Proportional Numbers)。数字 1 的字形宽度明显小于 8 或 0。当数值从 111,111 滚到 888,888 时,整行文本的总像素宽度剧烈波动,不断引发浏览器的文本重排与视觉晃动。

解决此问题的最优雅方案无需固定宽度或切分每一个字符,只需在展示数字的容器上声明 CSS 等宽数字特性:

.number-display {
  /* 强制将比例数字变为等宽数字,让 0~9 每个数字字符宽度完全一致 */
  font-variant-numeric: tabular-nums;
  -webkit-font-feature-settings: "tnum";
  font-feature-settings: "tnum";
}

添加这行声明后,无论数字怎样翻滚变换,千分位字符与数字各自保持精准的字符列宽,彻底消除整体左右抽搐的问题。

2. 金额小数位与千分位的协调

若滚动的对象是金额(例如保留 2 位小数),必须保证两点:

  • 千分位分隔符只打在整数部分:如果采用手写正则,必须将数值通过 split('.') 拆开,只对整数部分套用千分位正则,小数部分保持原样拼回,否则容易出现小数部分被错误插入逗号的严重 bug。
  • 小数位末尾补零:例如计算结果为 1250.5 时,金额展示规范应为 1,250.50。使用上文封装的 Intl.NumberFormat 并设置 minimumFractionDigits: 2 即可由浏览器原生自动补齐末尾零。

3. 动画被打断与防抖重入

在动态大屏或带有“刷新数据”按钮的页面中,用户可能在前一次数字滚动尚未完成时就再次触发更新。如果不对旧动画进行取消,两个 requestAnimationFrame 循环会同时向同一个 DOM 元素写入互不相同的计算值,造成数字剧烈乱跳。因此在函数开头将 element._animFrameId 取消,是编写高可靠动效不可或缺的防线。

JS数字滚动时怎么实时添加千分位分隔符
图 4:数字滚动实时千分位实践全景与避坑清单

六、总结与实践清单

在 JavaScript 中实现数字滚动时实时添加千分位,最稳妥的模式可总结为:“时钟交由 rAF,数值走缓动插值,格式化使用单例,视图排版加等宽”。

  • 数据流向明确:原始数值负责数学步进,千分位只在渲染到页面前做瞬时转换。
  • 性能不留隐患:格式化器放在循环外实例化一次,或在纯整型时采用正则,严禁逐帧构造对象。
  • 视觉质感细腻:采用三次缓出曲线消除突兀感,利用 tabular-nums 抹平字宽差异。
  • 结果绝对收敛:动画结束帧强制写入目标终值,消除累加浮点残差。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章