【VUE】解决 Element UI 中 el-tab 切换时 ECharts 渲染宽度问题

解决 Element UI 中 el-tab 切换时 ECharts 渲染宽度问题

在使用 Element UI 的 el-tabs 组件时，我们常常会遇到一个问题：当 ECharts 图表被放在非当前激活的 Tab 内时，图表无法正确渲染其宽度和高度。由于在 Tab 未激活状态下，图表的容器处于隐藏状态，ECharts 无法准确获取到其容器的尺寸，从而导致渲染错误。下面，我将详细介绍几种解决这一问题的方法，并提供相应的实现代码。

方案 1：监听 Tab 切换事件

首先，最直接的方法是监听 Tab 切换事件，在 Tab 被激活时初始化或者重新渲染图表。这样可以确保 ECharts 图表在获取容器宽度时容器已可见，因此能正确渲染。

// Vue 组件的 methods 中添加：
methods: {
  initEcharts() {
    this.chart = this.echarts.init(document.getElementById('chart'));
    this.chart.setOption({
      // ECharts 配置项
    });
  },
  handleTabChange(tab, event) {
    if (tab.name === 'tab2') {
      this.$nextTick(() => {
        this.initEcharts();
      });
    }
  }
}

<template>
  <el-tabs @tab-click="handleTabChange">
    <el-tab-pane label="Tab 1" name="tab1">Tab 1 content</el-tab-pane>
    <el-tab-pane label="Tab 2" name="tab2">
      <div id="chart" style="width: 100%; height: 400px;"></div>
    </el-tab-pane>
  </el-tabs>
</template>

在这个例子中，我们仅在用户点击到 Tab 2 时初始化 ECharts 图表。

方案 2：使用 echarts 的 resize 方法

有时候你可能已在某个时刻初始化了图表，但需要在 Tab 切换时调整图表的尺寸。此时可以使用 ECharts 提供的 resize 方法来调整图表。

methods: {
  handleTabChange(tab, event) {
    if (tab.name === 'tab2') {
      this.$nextTick(() => {
        this.chart.resize();
      });
    }
  }
}

这种方法简便而有效，特别是当图表的初始化操作因为某些原因（如数据依赖）必须在组件加载时就完成时。

方案 3：设置 echarts 图表容器的固定宽度

另一种简易的解决方式是在 CSS 中直接为 ECharts 图表的容器设置一个固定宽度，这样即使在 Tab 未激活时，图表的容器也已经有了确定的尺寸。

#chart {
  width: 600px; /* 或任何适合的宽度 */
  height: 400px;
}

这种方法适用于宽度固定不变的情况。

方案 4：延迟加载 echarts 图表

在某些复杂的情形下（例如，图表数据需要通过 AJAX 请求获取），可以在 Tab 切换并稳定后稍作延时再进行图表的渲染：

methods: {
  handleTabChange(tab, event) {
    if (tab.name === 'tab2') {
      setTimeout(() => {
        this.initEcharts();
      }, 300); // 延迟 300 毫秒初始化图表
    }
  }
}

方案 5：使用 CSS 动画

通过 CSS 将非活动的 Tab 设置为 visibility: hidden 而不是 display: none，因为使用 visibility 属性仍会保留元素的空间。

.el-tab-pane {
  visibility: hidden;
  height: 0; /* 隐藏内容，但不用 display: none */
}

.el-tab-pane.is-active {
  visibility: visible;
  height: auto; /* 显示内容 */
}