Excel Add-ins添加图表后自定义Tooltip的技术问询

我明白你在Excel Add-ins里自定义图表提示文本时遇到的麻烦了——默认的Tooltip格式带着'Series'和'Point'字样，确实不够直观，而且Office JS里没有直接修改Tooltip模板的属性。不过有两种可行的方案，你可以根据自己的Excel版本和场景选择：

方案一：用customTooltip属性直接自定义（推荐） #

如果你的Excel是365订阅版或者2019及以上版本，Office JS提供了Point.customTooltip属性，可以直接给每个数据点设置自定义的提示文本。这种方法最直接，能完全按照你的需求生成格式。

示例代码如下：

await Excel.run(async (context) => {
  // 获取当前工作表和目标图表（替换成你的图表名称）
  const activeSheet = context.workbook.worksheets.getActiveWorksheet();
  const targetChart = activeSheet.charts.getItem("YearTrendChart");
  
  // 获取图表的第一个系列（如果是多系列，需要遍历所有系列）
  const chartSeries = targetChart.series.getItemAt(0);
  // 加载数据点、分类（年份）和数值信息
  const points = chartSeries.points.load();
  const categoryValues = chartSeries.categories.load("values");
  const valueValues = chartSeries.values.load("values");
  
  await context.sync();
  
  // 遍历每个数据点，设置自定义Tooltip
  for (let i = 0; i < points.items.length; i++) {
    const currentPoint = points.items[i];
    const year = categoryValues.values[i];
    const percentage = valueValues.values[i];
    
    // 按照你想要的格式拼接文本
    currentPoint.customTooltip = `Year: ${year} Value: ${percentage.toFixed(1)}%`;
  }
  
  await context.sync();
});

注意事项： #

• 记得把代码里的图表名称替换成你实际使用的图表名称；
• 如果图表有多个系列，需要嵌套循环遍历所有系列的点；
• toFixed(1)是用来控制百分比的小数位数，你可以根据需求调整。

方案二：修改系列/点名称适配默认Tooltip（兼容旧版本） #

如果你的Excel版本不支持customTooltip，可以通过修改系列和数据点的名称来让默认Tooltip显示接近需求的内容。不过这种方法灵活性稍差，只能尽量调整：

await Excel.run(async (context) => {
  const activeSheet = context.workbook.worksheets.getActiveWorksheet();
  const targetChart = activeSheet.charts.getItem("YearTrendChart");
  const chartSeries = targetChart.series.getItemAt(0);
  
  // 把系列名称改成空，去掉Tooltip里的"Series"字样
  chartSeries.name = "";
  
  const points = chartSeries.points.load();
  const categoryValues = chartSeries.categories.load("values");
  
  await context.sync();
  
  // 把每个点的名称设置成"Year: 2014"格式
  for (let i = 0; i < points.items.length; i++) {
    points.items[i].name = `Year: ${categoryValues.values[i]}`;
  }
  
  await context.sync();
});

这种方法会让Tooltip显示成Point "Year: 2014"，虽然还带着"Point"，但已经比默认格式接近需求了。如果要加上数值，可能需要结合数据标签或者其他方式，但不如方案一直接。

内容的提问来源于stack exchange，提问作者Kashif