本文详解如何在 Chart.js 中通过返回数组而非字符串的方式，让自定义 tooltip 的 label 项垂直分行列出，解决 \n 换行失效问题，并适配嵌套对象数据结构。

本文详解如何在 chart.js 中通过返回数组而非字符串的方式，让自定义 tooltip 的 label 项垂直分行列出，解决 `\n` 换行失效问题，并适配嵌套对象数据结构。

在 Chart.js 中，当需要为折线图（或柱状图等）的每个数据点展示结构化、多条目的悬停信息（如多个订阅项及其数量），默认的 label 回调函数若返回单个含 \n 的字符串，不会自动换行渲染——这是因为 Chart.js 的 tooltip 引擎对字符串中的换行符不作 HTML 解析，而是将其视为普通字符，最终全部挤在同一行显示。

✅ 正确做法是：在 tooltips.callbacks.label 中返回一个字符串数组。Chart.js 会自动将数组中每一项渲染为 tooltip 中独立的一行（带前导圆点符号），从而实现清晰、可读的垂直列表效果。

以下是你原有代码的关键修复部分（已优化为现代语法并增强健壮性）：

tooltips: {
  callbacks: {
    label: function(tooltipItem, data) {
      const subscriptionObj = data.tooltipText?.[tooltipItem.index];
      if (!subscriptionObj || typeof subscriptionObj !== 'object') {
        return 'No subscription data';
      }

      const labelArr = [];
      for (const [key, value] of Object.entries(subscriptionObj)) {
        labelArr.push(`${key}: ${value}`);
      }
      return labelArr; // ✅ 返回数组，非字符串！
    },
    title: function(tooltipItems, data) {
      const idx = tooltipItems[0].index;
      return `${data.labels[idx]}  Total: ${data.datasets[0].data[idx]}`;
    }
  },
  displayColors: false,
  intersect: false,
  mode: 'index', // 推荐启用，确保同 x 轴位置的所有数据点被聚合（对多数据集更友好）
}

⚠️ 注意事项：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

• 切勿拼接 \n 字符串：return "a\nb" 在 Chart.js v2.x/v3.x 中均无效；
• tooltipText 需挂载到 data 对象顶层（你已正确做到），且确保 data.tooltipText[index] 是合法对象；
• 使用 Object.entries() 替代 for...in，避免原型链污染风险；
• 添加空值防护（?. 和类型检查），防止因数据缺失导致 JS 报错中断渲染；
• mode: 'index' 和 intersect: false 组合，可提升多点重叠时的 tooltip 稳定性。

? 进阶提示：如需进一步定制样式（如加粗键名、对齐数值、添加图标），可结合 external 自定义 tooltip 渲染，但对多数场景，返回数组已是简洁高效的解决方案。

通过这一改动，你的 tooltip 将从原本的单行混乱文本：

3x java 6 mujor 123123 (seanca): 1 |3x java mujor 12 (seanca): 1 |1x java ditor 1 (seanca): 1

优雅转变为清晰分列的多行结构：

• 3x java 6 mujor 123123 (seanca): 1  
• 3x java mujor 12 (seanca): 1  
• 1x java ditor 1 (seanca): 1

这不仅提升了用户体验，也使复杂业务数据（如多维度订阅统计）在图表中真正“可读、可信、可用”。