You need to enable JavaScript to run this app. 如何在Chartjs doughnet环形图的扇区中添加并显示文本
优惠活动
大模型
产品
解决方案
定价
更多

如何在Chartjs doughnet环形图的扇区中添加并显示文本

Chart.js 环形图扇区内置文本实现方法

Chart.js 原生没有提供直接在环形图扇区内部渲染文本的配置项。
不要用绝对定位的HTML元素叠加在图表上实现这个效果,图表缩放、动画播放时会出现文本位置错位,最稳定、无侵入的实现方式是编写自定义渲染插件,利用插件的绘制生命周期钩子,在环形扇区绘制完成后叠加对应文本,不会和原生交互、动画逻辑冲突。

核心实现逻辑

所有计算基于扇区本身的几何参数完成,不需要手动硬编码坐标:

  • 从图表元数据中读取每个扇区的startAngle(起始弧度)、endAngle(结束弧度)、innerRadius(内半径)、outerRadius(外半径)参数
  • 计算扇区的中心角度值,换算出扇区径向中点的坐标位置
  • 跳过角度过小的窄扇区,避免文本溢出、重叠
  • 在计算好的坐标位置绘制对应文本,适配和扇区背景的色彩对比度

可直接复用的完整代码

// 自定义扇区文本插件
const sliceInnerTextPlugin = {
  id: 'sliceInnerText',
  afterDatasetDraw(chart, args, options) {
    const ctx = chart.ctx;
    const currentDatasetMeta = args.meta;
    
    currentDatasetMeta.data.forEach((arc, sliceIndex) => {
      // 扇区占比过小时跳过绘制,防止文字拥挤
      const sliceAngle = arc.endAngle - arc.startAngle;
      if (sliceAngle < 0.2) return;

      // 计算文本放置的坐标位置
      const midAngle = (arc.startAngle + arc.endAngle) / 2;
      const midRadius = (arc.innerRadius + arc.outerRadius) / 2;
      const chartCenterX = (chart.chartArea.left + chart.chartArea.right) / 2;
      const chartCenterY = (chart.chartArea.top + chart.chartArea.bottom) / 2;
      const textX = chartCenterX + midRadius * Math.cos(midAngle);
      const textY = chartCenterY + midRadius * Math.sin(midAngle);

      // 绘制文本
      ctx.save();
      ctx.font = options.font || '12px system-ui';
      ctx.fillStyle = options.textColor || '#ffffff';
      ctx.textAlign = 'center';
      ctx.textBaseline = 'middle';
      const sliceLabel = chart.data.labels[sliceIndex];
      const sliceValue = chart.data.datasets[currentDatasetMeta.index].data[sliceIndex];
      ctx.fillText(`${sliceLabel} ${sliceValue}`, textX, textY);
      ctx.restore();
    })
  }
}

// 初始化环形图实例
new Chart(document.getElementById('doughnutChart'), {
  type: 'doughnut',
  data: {
    labels: ['产品A', '产品B', '产品C', '产品D'],
    datasets: [{
      data: [30, 40, 20, 10],
      backgroundColor: ['#3b82f6', '#ef4444', '#10b981', '#f59e0b'],
      borderWidth: 2,
      borderColor: '#fff'
    }]
  },
  options: {
    responsive: true,
    plugins: {
      sliceInnerText: {
        textColor: '#fff',
        font: '12px system-ui'
      }
    }
  },
  // 挂载自定义插件
  plugins: [sliceInnerTextPlugin]
})

效果适配说明

  • 如果需要调整文本在扇区的径向位置,可以修改midRadius的计算逻辑,比如把数值乘0.8就能让文本更靠近环形内圈,乘1.2就更靠近外圈
  • 要实现多行文本的渲染效果,可以拆分文本内容,每次绘制时累加textY的偏移量,逐行渲染
  • 小扇区判断的阈值(代码中的0.2弧度)可以根据实际图表大小调整,避免文字重叠

内容的提问来源于stack exchange,提问作者Talha Talha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 12:45:04