在go-echarts中自定义Tooltip格式化显示

go-echarts是一个基于ECharts的Go语言图表库，它允许开发者在Go中生成各种交互式图表。在实际使用中，我们经常需要对图表中的Tooltip（提示框）进行自定义格式化显示，以满足特定的业务需求。

Tooltip格式化基础

在go-echarts中，Tooltip的格式化可以通过Formatter属性来实现。基础格式化使用字符串模板方式：

charts.WithTooltipOpts(opts.Tooltip{
    Formatter: "{b}: {c}小时",
})

这种简单的字符串格式化适用于大多数基础场景，其中{b}表示类目值，{c}表示数值。

使用JavaScript函数进行高级格式化

当我们需要更复杂的格式化逻辑时，可以使用JavaScript函数来实现。在go-echarts中，可以通过以下方式插入JS函数：

const tooltipJSFunc = `function (params) {
    var hours = Math.floor(params.value);
    var minutes = Math.round((params.value - hours) * 60);
    return hours + '小时' + minutes + '分钟';
}`

charts.WithTooltipOpts(opts.Tooltip{
    Formatter: opts.FuncOpts(tooltipJSFunc),
})

这种方式允许我们实现任意复杂的格式化逻辑，比如：

• 将小时数转换为"小时:分钟"格式
• 根据数值范围显示不同的颜色或图标
• 添加额外的计算字段或说明文字

实际应用示例

假设我们需要显示每周屏幕使用时间，并将小数小时转换为"X小时Y分钟"格式：

func createWeekStatChart(data ChartData) {
    bar := charts.NewBar()
    
    // 定义Tooltip的JS格式化函数
    const tooltipFormatter = `function (params) {
        var value = params[0].value;
        var hours = Math.floor(value);
        var minutes = Math.round((value - hours) * 60);
        return params[0].name + '<br/>' + 
               '使用时间: ' + hours + '小时' + minutes + '分钟';
    }`
    
    bar.SetGlobalOptions(
        charts.WithTooltipOpts(opts.Tooltip{
            Trigger:   "axis",
            Formatter: opts.FuncOpts(tooltipFormatter),
        }),
        // 其他图表选项...
    )
    
    // 添加数据系列...
}

注意事项

1. JS函数字符串：必须确保JavaScript函数是有效的，并且正确处理了参数。在示例中，params是一个数组，每个元素代表一个系列的数据。

2. 性能考虑：复杂的JS格式化函数可能会影响图表渲染性能，特别是在数据量大的情况下。

3. 兼容性：确保使用的JS语法与ECharts版本兼容。

4. 调试技巧：可以在浏览器开发者工具中调试JS格式化函数，确认其正确性后再集成到Go代码中。

通过灵活运用这些技术，开发者可以在go-echarts中创建出高度定制化的Tooltip显示效果，大大提升图表的可读性和用户体验。