本文档旨在解决在使用 amCharts 5 时，如何访问和处理嵌套在数据对象中的值。当数据源包含多层结构，例如数组中的对象，而每个对象又包含数组时，直接通过 valueYField 访问数据可能会遇到问题。本文将提供一种预处理数据的方法，以便 amCharts 5 能够正确解析和显示这些数据。
理解问题
在使用 amCharts 5 构建图表时，通常会提供一个数据数组，其中每个对象代表图表中的一个数据点。valueYField 属性用于指定对象中哪个字段的值应该用作 Y 轴的值。
例如，以下数据结构可以直接被 amCharts 5 解析：
var data = [
{ year: "1930", italy: 4, germany: 5.1, uk: 3 },
{ year: "1934", italy: 1, germany: 2, uk: 6 },
{ year: "1938", italy: 2, germany: 3, uk: 1 }
];但是，如果数据结构更复杂，例如：
var data = [
{ year: "1930", italy: [{ aa: 20, bb: "21" }], germany: [{ aa: 30, bb: "44" }], uk: [{ aa: 40, bb: "77" }] }
];直接使用 valueYField: "italy" 将无法正确解析数据，因为 "italy" 字段包含的是一个数组，而不是一个可以直接用于 Y 轴的值。
解决方案：数据预处理
由于 amCharts 5 本身不支持直接访问嵌套对象中的值，因此需要对数据进行预处理，将其转换为 amCharts 5 可以直接使用的格式。
以下代码展示了如何使用 JavaScript 的 map 和 Object.fromEntries 方法来转换数据：
series.data.setAll(data
.map(o=>Object.fromEntries(Object.entries(o)
.map(([k, v])=>[k, v?.[0]?.aa ?? v]))
)
)这段代码做了以下事情：
- data.map(o => ...): 遍历原始数据数组 data，对每个对象 o 执行转换操作。
- Object.entries(o): 将对象 o 转换为键值对的数组。例如，{ year: "1930", italy: [{ aa: 20, bb: "21" }] } 转换为 [["year", "1930"], ["italy", [{ aa: 20, bb: "21" }]]]。
-
.map(([k, v]) => [k, v?.[0]?.aa ?? v]): 遍历键值对数组，对每个键值对进行转换。
- [k, v]：解构键值对，k 是键，v 是值。
- v?.[0]?.aa ?? v：尝试访问嵌套在 v 中的 aa 属性。
- v?.：使用可选链操作符，如果 v 是 null 或 undefined，则直接返回 undefined，避免出错。
- [0]：访问数组的第一个元素。
- ?.aa：使用可选链操作符访问第一个元素的 aa 属性。
- ?? v：使用空值合并运算符，如果 v?.[0]?.aa 的结果是 null 或 undefined，则返回原始值 v。
- [k, ...]：将转换后的值与原始键组合成新的键值对。
- Object.fromEntries(...): 将键值对数组转换回对象。
完整示例代码：
am5.ready(function() {
// 创建根元素
var root = am5.Root.new("chartdiv");
root._logo.dispose();
// 设置主题
root.setThemes([
am5themes_Animated.new(root)
]);
// 创建图表
var chart = root.container.children.push(
am5xy.XYChart.new(root, {
panX: true,
panY: true,
wheelX: "panX",
wheelY: "zoomX",
layout: root.verticalLayout,
pinchZoomX:true
})
);
// 添加游标
var cursor = chart.set("cursor", am5xy.XYCursor.new(root, {
behavior: "none"
}));
cursor.lineY.set("visible", false);
// 数据
var data = [{year:"1930", italy:[{aa:20,bb:"21"}], germany:[{aa:30,bb:"44"}], uk:[{aa:40,bb:"77"}] },
{year: "1934", italy: 1,germany: 2,uk: 6}, {year: "1938",italy: 2,germany: 3,uk: 1}];
// 创建坐标轴
var xRenderer = am5xy.AxisRendererX.new(root, {});
xRenderer.grid.template.set("location", 0.5);
xRenderer.labels.template.setAll({
location: 0.5,
multiLocation: 0.5
});
var xAxis = chart.xAxes.push(
am5xy.CategoryAxis.new(root, {
categoryField: "year",
renderer: xRenderer,
tooltip: am5.Tooltip.new(root, {})
})
);
xAxis.data.setAll(data);
var yAxis = chart.yAxes.push(
am5xy.ValueAxis.new(root, {
maxPrecision: 1,
renderer: am5xy.AxisRendererY.new(root, {
inversed: false
})
})
);
// 创建序列
function createSeries(name, field) {
var series = chart.series.push(
am5xy.LineSeries.new(root, {
name: name,
xAxis: xAxis,
yAxis: yAxis,
valueYField: field,
categoryXField: "year",
tooltip: am5.Tooltip.new(root, {
pointerOrientation: "horizontal",
labelText: "[bold]{name}[/]\n{categoryX}: {valueY}"
})
})
);
series.bullets.push(function() {
return am5.Bullet.new(root, {
sprite: am5.Circle.new(root, {
radius: 5,
fill: series.get("fill")
})
});
});
series.set("setStateOnChildren", true);
series.states.create("hover", {});
series.mainContainer.set("setStateOnChildren", true);
series.mainContainer.states.create("hover", {});
series.strokes.template.states.create("hover", {
strokeWidth: 4
});
// 预处理数据
series.data.setAll(data.map(o=>Object.fromEntries(Object.entries(o).map(([k, v])=>[k, v?.[0]?.aa ?? v]))))
series.show(1000);
}
createSeries("Italy", "italy");
createSeries("Germany", "germany");
createSeries("UK", "uk");
// 创建图例
var legend = chart.children.push(
am5.Legend.new(root, {
centerX: am5.percent(90),
x: am5.percent(90),
centerY: am5.percent(105),
y: am5.percent(105),
})
);
legend.itemContainers.template.states.create("hover", {});
legend.itemContainers.template.events.on("pointerover", function(e) {
e.target.dataItem.dataContext.hover();
});
legend.itemContainers.template.events.on("pointerout", function(e) {
e.target.dataItem.dataContext.unhover();
});
legend.data.setAll(chart.series.values);
// 图表动画
chart.appear(1000, 100);
});HTML 和 CSS 代码：
amCharts 5 Example
注意事项：
- 确保在 HTML 文件中引入 amCharts 5 的相关库文件。
- 根据实际的数据结构，修改 v?.[0]?.aa 中的索引和属性名。
- 如果数据结构更加复杂，可能需要编写更复杂的预处理逻辑。
总结
通过对数据进行预处理，可以解决 amCharts 5 无法直接访问结构化数据对象中的值的问题。这种方法可以灵活地处理各种复杂的数据结构，确保 amCharts 5 能够正确地解析和显示数据。在实际应用中，需要根据具体的数据结构和需求，调整预处理逻辑。
