amCharts数据值获取方法详解

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《amCharts 访问数据对象值方法》，这篇文章主要讲到等等知识，如果你对文章相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

本文档旨在解决在 amCharts 中处理包含嵌套数据结构的 JSON 对象时，如何正确访问和解析数据，以便在图表中展示。由于 amCharts 本身的数据字段功能不支持直接访问子对象，因此我们将介绍一种预处理数据的方法，以便能够正确地将数据绑定到图表序列上。

理解问题

在使用 amCharts 创建图表时，我们通常需要将数据源绑定到图表的序列上。当数据源是简单的键值对时，例如：

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 属性指定要使用的字段名。但是，当数据源包含嵌套的结构，例如：

var data = [
  { year: "1930", italy: [{ aa: 20, bb: "21" }], germany: [{ aa: 30, bb: "44" }], uk: [{ aa: 40, bb: "77" }] }
];

amCharts 默认情况下无法直接访问 italy[0].aa 这样的嵌套值。

解决方案：数据预处理

由于 amCharts 不支持直接访问嵌套对象，我们需要在将数据绑定到图表之前，对数据进行预处理。预处理的目的是将嵌套的数据结构转换为 amCharts 可以直接识别的键值对。

以下是一个通用的 JavaScript 代码片段，用于处理包含嵌套数组的数据结构：

data.map(o => Object.fromEntries(Object.entries(o).map(([k, v]) => [k, v?.[0]?.aa ?? v])))

这段代码使用 map 函数遍历数据数组，并使用 Object.fromEntries 和 Object.entries 将每个对象转换为键值对的形式。关键部分是 v?.[0]?.aa ?? v，它尝试访问嵌套数组中的 aa 属性，如果不存在，则使用原始值 v。这使得代码能够同时处理嵌套和非嵌套的数据结构。

示例代码

以下是一个完整的示例，展示了如何使用上述预处理方法将数据绑定到 amCharts 图表：

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>

在这个例子中，我们在 createSeries 函数中，使用 series.data.setAll() 方法将预处理后的数据绑定到序列上。

注意事项

• 确保预处理逻辑与您的数据结构相匹配。如果数据结构更复杂，可能需要调整预处理代码。
• 预处理会增加一些计算开销，特别是当数据量很大时。如果性能是一个关键问题，可以考虑在服务器端进行数据预处理。
• 这种方法假设您需要访问嵌套数组中的第一个元素的 aa 属性。如果需要访问其他属性或元素，请相应地修改代码。

总结

虽然 amCharts 本身不支持直接访问嵌套数据结构，但通过预处理数据，我们可以轻松地将包含嵌套对象的 JSON 数据绑定到图表上。这种方法提供了一种灵活的方式来处理各种复杂的数据结构，并确保图表能够正确地显示数据。 记住，理解您的数据结构并相应地调整预处理代码是至关重要的。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《amCharts数据值获取方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。