本文档介绍了在使用 amCharts 5 时，如何处理包含嵌套结构的数据对象。由于 amCharts 5 本身不支持直接访问数据字段中的子对象，因此需要对数据进行预处理，以便正确地在图表中显示和使用这些数据。本文将提供一个有效的解决方案，通过数据预处理来提取嵌套值，并将其应用于图表。
理解问题
在使用 amCharts 5 创建图表时，通常会使用 valueYField 属性来指定用于绘制图表的数据字段。当数据结构简单时，例如：
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 }
];可以直接将 valueYField 设置为 "italy", "germany" 或 "uk" 来分别绘制意大利、德国和英国的数据线。
然而，当数据结构变得复杂，包含嵌套的对象或数组时，例如：
var data = [
{ year: "1930", italy: [{ aa: 20, bb: "21" }], germany: [{ aa: 30, bb: "44" }], uk: [{ aa: 40, bb: "77" }] }
];直接使用 valueYField 将无法正确解析数据，因为 amCharts 5 默认不支持访问嵌套对象中的属性。
解决方案：数据预处理
由于 amCharts 5 不直接支持在 valueYField 中访问嵌套对象，因此需要在将数据传递给图表之前对其进行预处理。预处理的目的是将嵌套的数据结构转换为 amCharts 5 可以直接使用的扁平结构。
以下是一个使用 JavaScript 的 map 和 Object.fromEntries 方法进行数据预处理的示例：
data.map(o => Object.fromEntries(Object.entries(o).map(([k, v]) => [k, v?.[0]?.aa ?? v])))
这段代码的作用是：
- data.map(...): 遍历原始数据数组 data，对每个数据项进行转换。
- Object.entries(o): 将每个数据项 o 转换为键值对的数组。
- .map(([k, v]) => ...): 遍历键值对数组，对每个键值对进行处理。 k 是键（例如 "year", "italy"），v 是值（例如 "1930", [{aa: 20, bb: "21"}]）。
-
[k, v?.[0]?.aa ?? v]: 这是关键部分，它处理了嵌套对象：
- v?.[0]?.aa: 尝试访问 v 的第一个元素的 aa 属性。使用了可选链操作符 ?.，以避免当 v 不是数组或 v 的第一个元素没有 aa 属性时出错。
- ?? v: 使用空值合并运算符 ??。如果 v?.[0]?.aa 的值为 null 或 undefined，则使用原始值 v。这意味着如果数据已经是扁平的（例如 year 字段），则保持不变。
- Object.fromEntries(...): 将处理后的键值对数组转换回一个对象。
示例：
如果原始数据是：
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 }
];经过预处理后，数据将变为：
[
{ year: "1930", italy: 20, germany: 30, uk: 40 },
{ year: "1934", italy: 1, germany: 2, uk: 6 },
{ year: "1938", italy: 2, germany: 3, uk: 1 }
];现在，italy, germany 和 uk 字段直接包含数值，可以直接在 valueYField 中使用。
代码示例
以下是完整的代码示例，展示了如何将数据预处理应用于 amCharts 5 图表：
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);
});#chartdiv {
width: 100%;
height: 300px;
}<div id="chartdiv"></div> <script src="https://cdn.amcharts.com/lib/5/index.js"></script> <script src="https://cdn.amcharts.com/lib/5/xy.js"></script> <script src="https://cdn.amcharts.com/lib/5/themes/Animated.js"></script>
在这个示例中，series.data.setAll() 方法接收经过预处理的数据。 createSeries 函数被用于创建 Italy, Germany, 和 UK 三个序列，每个序列都使用相应预处理后的数据。
总结
虽然 amCharts 5 不直接支持访问嵌套数据结构中的值，但通过数据预处理，可以有效地解决这个问题。 使用 map 和 Object.fromEntries 的组合可以灵活地处理各种嵌套数据结构，并将其转换为 amCharts 5 可以直接使用的数据格式。 在设置 series.data 之前进行预处理，确保图表能够正确显示和使用数据。
