在Google Apps Script中为已创建图表添加自定义提示框（无需新建）

我在Google Apps Script里要给已创建的图表加自定义提示框，但搜到的方案全是新建图表——可这个图表已经发布到网站上，必须保留原图表，那些方案根本用不了。我本来想照着修改图表颜色的路子来做，结果试了行不通。

基础代码布局 #

function AddTooltips(charts, ranges, tooltips, sheet)
{
  for(i = 0; i < charts.length; i++)
  {
    var chart = charts[i]
    if(chart.getRanges()[0].getA1Notation() == ranges[i])
    {
      // 这里需要添加代码
    }

  }
}

参考：修改柱状图颜色的方式 #

.setOption('series.0.items.0.color', '#00FF00')
.setOption(...)
...
.build()
sheet.updateChart(chart)

可行解决方案 #

要给已发布的原图表添加自定义提示框，不用新建图表，直接通过modify()获取原图表的构建器，设置提示框选项后再更新原图表即可，这样能保留原图表的发布状态。

修改后的完整代码如下：

function AddTooltips(charts, ranges, tooltips, sheet) {
  for (let i = 0; i < charts.length; i++) {
    const chart = charts[i];
    if (chart.getRanges()[0].getA1Notation() === ranges[i]) {
      // 获取原图表的构建器
      const chartBuilder = chart.modify();
      
      // 启用HTML自定义提示框，同时设置基础样式
      chartBuilder.setOption('tooltip.isHtml', true)
                  .setOption('tooltip.textStyle.color', '#333')
                  .setOption('tooltip.boxStyle.backgroundColor', '#f5f5f5')
                  // 针对第一个系列设置自定义提示内容格式
                  .setOption('series.0.tooltip.formatter', function(params) {
                    // 这里可以根据需求自定义HTML格式的提示内容，结合传入的tooltips数据
                    return `<div style="padding: 8px; border-radius: 4px;">
                              <strong>${params.name}</strong><br>
                              数值：${params.value}<br>
                              自定义说明：${tooltips[i]}
                            </div>`;
                  });
      
      // 构建更新后的图表并替换原图表
      const updatedChart = chartBuilder.build();
      sheet.updateChart(updatedChart);
    }
  }
}

注意要点 #

• 不同类型的图表（柱状图、折线图、饼图等），提示框的配置路径可能有差异，需要根据实际图表类型调整setOption的参数。
• 如果需要给每个数据点单独设置提示内容，可在formatter函数中通过params.index来匹配tooltips数组中对应的具体数据。
• 必须开启tooltip.isHtml才能使用HTML格式的自定义提示框，若只用纯文本，可省略该选项，直接在formatter中返回字符串即可。

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