在 AmCharts 5 中，你无法直接在 labelText 模板字符串中调用 JavaScript 函数（例如 {Math.abs(valueY)}），必须借助 adapters 或 formatter 来实现动态格式化。本文详细解析这两种推荐方案及最佳实践，帮助你在 AmCharts 5 中高效定制 tooltip 显示格式。
先给出结论：AmCharts 5 的 tooltip 文本渲染机制与 v4 版本差异较大。一个关键限制是——labelText 仅支持静态占位符，比如 {name}、{valueY}，但嵌入内联表达式或者直接调用函数（如 {Math.abs(valueY)}）是行不通的。如果你需要对数值进行绝对值计算、倍数转换、货币格式化，或者调用自定义逻辑，就必须借助底层扩展机制：adapters 或 formatter。
✅ 推荐方案一：使用 tooltip.label.adapters.add("text", ...)（最灵活、最常用）
首先介绍 adapters 方案。这是官方推荐且功能最强大的做法，适合各种复杂场景。核心思路是：在 tooltip 文本实际渲染前“拦截”它，然后自行改写。
// 假设已定义自定义格式化函数
function customFun(value) {
if (value == null) return "—";
return Math.round(value * 100) / 100; // 保留两位小数
}
// 在 series 配置后，为 tooltip label 添加适配器
series2.get("tooltip").label.adapters.add("text", function(text, target) {
const dataItem = series2.get("tooltipDataItem");
if (!dataItem) return text;
const name = series2.get("name") || "";
const valueY = dataItem.get("valueY");
const formattedValue = customFun(valueY);
return `${name}: $${formattedValue}`;
});
几个关键点需要留意：
tooltipDataItem是当前悬停数据点的完整 DataItem 对象，通过它可以获取原始字段，例如 .get("valueY")、.get("categoryX")。target是 tooltip 内部的 Label 实例，text通常是默认的占位符文本，多数情况下为空，可以忽略。- 适配器内部必须显式返回一个字符串，否则 tooltip 会显示空白。
- 每次 tooltip 显示时都会触发该方法，性能开销低，实时计算完全没问题。
✅ 推荐方案二：使用 tooltip.formatter（仅限简单数值转换）
如果你只需要对 valueY 进行轻量级处理，例如取绝对值、乘以系数、添加单位符号，那么 formatter 方案会更简洁。
tooltip: am5.Tooltip.new(root, {
pointerOrientation: "horizontal",
formatter: function(value, info) {
// value 是当前数据点的 valueY 值
// info 包含上下文（如 dataItem、field、axis 等），但通常无需使用
return Math.abs(value) + " $";
}
}),
tooltipText: "{name}: {valueY}" // 这里的占位符仅用于触发 tooltip 显示，实际文本由 formatter 决定
需要说明的是，formatter 只接收 value（即 valueY 字段值）和 info 对象，不会提供系列名、类别等上下文信息。因此它仅适合纯数值加工的简单场景。如果要将多个字段组合在一起，例如“{name} in {categoryX}: $...”，仍然需要使用 adapters 方案。
? 总结与最佳实践
| 场景 | 推荐方案 | 说明 |
|---|---|---|
| 仅格式化 valueY（如加单位、取整、取绝对值） | formatter | 代码简短，语义清晰，易于维护 |
| 需组合多个字段（{name}、{categoryX}、{valueY}）或调用复杂逻辑 | label.adapters.add("text", ...) | 完全可控，是 AmCharts 5 的标准扩展方式 |
| 需全局统一格式（如所有 tooltip 统一货币符号） | 在 root 或 chart 级配置 NumberFormatter | 适用于基础数字格式（千分位、小数位），但不支持自定义函数 |
最后再提醒一句：不要在 labelText 中尝试写入 {Math.abs(valueY)} 或 {customFunction(valueY)}——这种写法在 AmCharts 5 中是无效的，结果要么占位符原样输出，要么直接报错。坚持“模板占位符 + 适配器/格式器”的分离原则，才能打造出既灵活又可靠的 tooltip 定制方案。
