Apache ECharts 中双轴柱状图的正确配置方法

在使用 Apache ECharts 绘制双轴柱状图时，开发者经常会遇到一个常见问题：当两个数据系列的值范围差异较大时，其中一个系列可能无法正常显示。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题现象分析

当我们需要在同一个图表中展示两个不同量纲的数据时（例如产量和良率），直接使用默认配置会导致量纲较小的数据系列（如良率百分比）几乎不可见。这是因为默认情况下，ECharts 会将所有系列数据关联到第一个坐标轴上。

核心解决方案

要解决这个问题，关键在于正确配置 xAxisIndex 属性。每个数据系列都可以通过这个属性指定它所关联的坐标轴索引（从0开始计数）。

series: [
  {
    name: '产量',
    type: 'bar',
    data: productDataArray
  },
  {
    name: '良率',
    type: 'bar',
    xAxisIndex: 1,  // 关键配置：指定使用第二个X轴
    data: productRateDataArray
  }
]

完整配置示例

以下是一个完整的双轴柱状图配置示例，展示了如何同时显示产量（数值较大）和良率（百分比）两个数据系列：

const option = {
  title: {
    text: '产品产量/良率'
  },
  tooltip: {
    trigger: 'axis'
  },
  legend: {
    data: ['产量','良率']
  },
  xAxis: [
    {
      type: 'value',
      name: '产量',
      axisLabel: {
        formatter: '{value}'
      }
    },
    {
      type: 'value',
      name: '良率',
      min: 0,
      max: 100,
      axisLabel: {
        formatter: '{value}%'
      }
    }
  ],
  yAxis: {
    type: 'category',
    data: productsArray,
    axisLabel: {
      formatter: function (value) {
        const maxLength = 10;
        return value.length > maxLength ? 
          value.substring(0, maxLength) + '...' : value;
      }
    }
  },
  series: [
    {
      name: '产量',
      type: 'bar',
      data: productDataArray
    },
    {
      name: '良率',
      type: 'bar',
      xAxisIndex: 1,
      data: productRateDataArray
    }
  ]
};

最佳实践建议

1. 明确量纲差异：当两个数据系列的单位或量纲不同时，务必考虑使用双轴配置
2. 坐标轴对齐：确保两个坐标轴的刻度线对齐，便于数据对比
3. 视觉区分：为不同系列使用明显区分的颜色或样式
4. 标签优化：对于较长的分类标签，使用截断或换行处理

通过正确配置 xAxisIndex 属性，开发者可以轻松实现多轴数据的同时展示，使图表数据呈现更加清晰和专业。