在 AmCharts 5 中，无法直接在 labelText 模板字符串中调用 JavaScript 函数（如 {Math.abs(valueY)}），必须通过 adapters 或 formatter 实现动态格式化，本文详解两种推荐方案及最佳实践。
在 amcharts 5 中，无法直接在 `labeltext` 模板字符串中调用 javascript 函数（如 `{math.abs(valuey)}`），必须通过 `adapters` 或 `formatter` 实现动态格式化，本文详解两种推荐方案及最佳实践。
AmCharts 5 的 tooltip 文本渲染机制与 v4 有显著差异：labelText 仅支持静态占位符（如 {name}、{valueY}），不支持内联表达式或函数调用。若需对数值进行绝对值计算、倍数变换、货币格式化或调用自定义逻辑（如 customFunction(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)} —— 这类语法在 v5 中无效，会导致占位符原样输出或报错。始终遵循“模板占位符 + 适配器/格式器”的分离原则，才能实现真正灵活、可维护的 tooltip 定制。
