【vue组件封装】ECharts组件封装记录

1. 封装思路

1.1 观察文档,考虑组件需要的基本参数

每个组件需要的参数都很固定,包含:基本参数+独有参数

我们要做的就是:分离基本参数,父组件向子组件传递基本参数和独有参数

1.2 参数筛选,分为父组件传来的参数和自身参数

父组件传递的一般为基本参数,自身的参数为独有参数

1.3 完善组件,观察个别处与理想有无出入,更改配置项达到理想态
1.4 细节优化,考虑多种场景下,图表自适应处理
2. ECharts 组件的封装
2.1 通过观察文档;常用的 ECharts组件都包含的配置项为: series,一些带坐标轴的图表都包含配置项:xAxis 、yAxis
2.2 我们在组件的 props 中接收父组件传递的参数,根据参数判断其是否有坐标轴,然后动态的渲染不同类型的图表(通过计算属性判断)
2.3 在ECharts 组件中定义两个方法:1、渲染组件的方法;2、渲染数据的方法(写在组件渲染前)
2.4 通过侦听器来监控 ECharts 组件接收的值是否放生改变,若改变就调用组件的渲染方法(达到视图的渲染)

具体封装代码(ECharts.vue)

<template>
  <div style="height:100%" ref="echart"></div>
</template>

<script>
import echarts from 'echarts';
export default {
  props: {
    // 接收父组件传递的ECharts 数据
    chartData: {
      //定义出需要动态传递的参数
      type: Object,
      default() {
        return {
          xData: [],
          series: [],
        };
      },
    },
    isAxisChart: {
      type: Boolean,
      default: true,
    },
  },
  data() {
    return {
      //返回要渲染的数据
      echart: null,
      //# 含坐标轴的图表
      axisOption: {
        xAxis: {
          //x轴数据
          type: 'category',
          data: [],
        },
        yAxis: [
          //y轴数据(根据series 中的date 渲染)
          {
            type: 'value',
          },
        ],
        series: [], //数据渲染的结构
      },
      //# 不含坐标轴的图表
      noAxisOption: {
        series: [],
      },
    };
  },
  computed: {
    //计算属性判断 是否渲染坐标轴
    options() {
      return this.isAxisChart ? this.axisOption : this.noAxisOption;
    }
  },
  watch: {
    chartData: {
      handler() {
        this.initChart();
      },
      deep: true, // 需要deep属性对 对象进行深度监听
    }
  },
  methods: {
    initChart() {
      //# 初始化容器时,初始化数据
      this.initChartData();
      //初始化容器(图标)
      if (this.echart) {
        //若容器存在,直接渲染数据(官方api 写入配置)
        this.echart.setOption(this.options);
      } else {
        this.echart = echarts.init(this.$refs.echart);
        this.echart.setOption(this.options);
      }
    },
    initChartData() {
      //初始化数据
      if (this.isAxisChart) {
        //#把自身的数据替换成父组件传过来的数据
        this.axisOption.xAxis.data = this.chartData.xData;
        this.axisOption.series = this.chartData.series;
      } else {
        this.noAxisOption.series = this.chartData.series;
      }
    },
  },
};
</script>
<style lang='less' scoped>
</style>

父组件代码:

 <el-card shadow="hover">
            <echart style="height:260px" :chartData="echartData.user"></echart>
 </el-card>
 <el-card shadow="hover">
            <!-- 要用isAxisChart 来告诉子组件渲染的图表格式 -->
            <echart style="height:260px" :chartData="echartData.video" :isAxisChart = "false"></echart>
 </el-card>

注意:对于 ECharts 组件中的参数格式,可根据 ECharts 官网进行配置—ECharts官网
last
优化后的 ECharts 组件

<template>
  <div style="height:100%" ref="echart"></div>
</template>

<script>
import echarts from 'echarts';
export default {
  props: {
    // 接收父组件传递的ECharts 数据
    chartData: {
      //定义出需要动态传递的参数
      type: Object,
      default() {
        return {
          xData: [],
          series: [],
        };
      },
    },
    isAxisChart: {
      type: Boolean,
      default: true,
    },
  },
  computed: {
    //计算属性判断 是否渲染坐标轴
    options() {
      return this.isAxisChart ? this.axisOption : this.noAxisOption;
    },
    collapse() {
      return this.$store.state.isCollapse;
    },
  },
  data() {
    return {
      //返回要渲染的数据
      echart: null,
      //# 含坐标轴的图表
      axisOption: {
        tooltip: {
          tirgger: 'item',
        },
        legend: {
          textStyle: {
            color: '#333',
          },
        },
        xAxis: {
          //x轴数据
          type: 'category',
          data: [],
          axisLine: {
            lineStyle: {
              color: '#33CC00',
            },
          },
        },
        yAxis: [
          //y轴数据(根据series 中的date 渲染)
          {
            type: 'value',
          },
        ],
        // 配置展示数据的颜色
        color: [
          '#CC66FF',
          '#33FF00',
          '#663300',
          '#FF3300',
          '#999900',
          '#FFFF00',
        ],
        series: [], //数据渲染的结构
      },
      //# 不含坐标轴的图表
      noAxisOption: {
        tooltip: {
          tirgger: 'item',
        },
        legend: {
          textStyle: {
            color: '#333',
          },
        },
        color: [
          '#CC66FF',
          '#33FF00',
          '#663300',
          '#FF3300',
          '#999900',
          '#FFFF00',
        ],
        series: [],
      },
    };
  },
  watch: {
    chartData: {
      handler() {
        this.initChart();
      },
      deep: true,
    },
    collapse() {
      setTimeout(this.listenResize, 300); // 监听折叠变量(实现折叠响应式变化图标)
    },
  },
  methods: {
    initChart() {
      //# 初始化容器时,初始化数据
      this.initChartData();
      //初始化容器(图标)
      if (this.echart) {
        //若容器存在,直接渲染数据(官方api 写入配置)
        this.echart.setOption(this.options);
      } else {
        this.echart = echarts.init(this.$refs.echart);
        this.echart.setOption(this.options);
      }
    },
    initChartData() {
      //初始化数据
      if (this.isAxisChart) {
        //#把自身的数据替换成父组件传过来的数据
        this.axisOption.xAxis.data = this.chartData.xData;
        this.axisOption.series = this.chartData.series;
      } else {
        this.noAxisOption.series = this.chartData.series;
      }
    },
    listenResize() {
      //# 监听浏览器尺寸,做出响应式展示
      this.echart ? this.echart.resize() : '';
    },
  },
  mounted() {
    // 挂载钩子,判断窗口大小
    window.addEventListener('resize', this.listenResize);
  },
  destroyed() {
    // 挂载卸载钩子,防止内存泄漏
    window.removeEventListener('resize', this.listenResize);
  },
};
</script>
<style lang='less' scoped>
</style>

注意:优化后的组件,新增了自定义颜色以及响应式的处理

心得
对于大部分组件的封装与 ECharts 组件的封装大同小异,我们要找到基本参数,然后逐步解析,本文结束。

愿所有的美好都与你环环相扣,加油。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,384评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,845评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,148评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,640评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,731评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,712评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,703评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,473评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,915评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,227评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,384评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,063评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,706评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,302评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,531评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,321评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,248评论 2 352

推荐阅读更多精彩内容