[发明专利]一种简化echarts调用的封装方法

权利要求书

1.一种简化echarts调用的封装方法，其特征在于：通过参数分类、简化映射、定义默认值、模块封装处理方式构造一个带html元素ID值和对应echarts配置参数的批量json数据；其中echarts配置参数为简化后或原生态的配置参数，调用封装程序中的接口解析json数据，使用echarts批量生成图表；

所述的批量json数据采用以下形式：

var config＝{“chart1”:chart1_config}；

其中key值即chart1为需要展示图表的html元素的ID值，chart1_config是chart1对应的echarts配置参数，同样使用了json格式，配置参数为经过封装后的json数据和/或原生的json数据，调用函数判断当前配置参数的类型，决定是否调用解析逻辑将封装后的json配置参数解析成echarts原生的json配置参数；

所述的封装程序将参数解析、定义默认参数和echarts引入调用逻辑封装在一个js文件中，免去echarts引入和加载模块问题；使用封装程序定义的配置参数生成echarts图形报表。

2.根据权利要求1所述的简化echarts调用的封装方法，其特征在于：所述方法的具体流程为：

第一步，引入echarts.js主文件和封装模块createEcharts.js两个文件；

第二步，修改封装js模块文件顶部的echarts路径并引入；

第三步，通过调用Echarts.load({domID:config})的接口传入数据，load遍历数据，判断config是封装模块定义的配置参数还是echarts原生的配置参数，对不同的参数执行不同的处理：

对echarts原生的配置参数调用模块内orginalCreate的方法简单地使用echarts直接生成图形，对模块定义的配置参数则通过解析生成echarts原生的参数配置后再调用echarts生成图形；

第四步，模块定义的配置参数解析成原生的echarts配置参数；

第五步，使用解析过的参数使用echarts生成图表的原生接口生成图表。

3.根据权利要求2所述的简化echarts调用的封装方法，其特征在于：将所述的第四步中原生的echarts配置参数整理成四类，并采用不同的处理方式：

A、数据展示参数：数据展示参数是必须参数，通过映射的方式使用更简单的方式传入；其中，title和subtitle需要原生的参数通过以下方式传入：title:{text:’主标题’,subtext:’副标题’}，封装的方式是将主标题和副标题拆分成两个参数分别使用title:’主标题’,subTitle:’副标题’这样的形式传入，而封装程序做逆向操作，将拆分的参数组装成原生的参数，其他必须参数也是采用此解析方式；

B、固定样式参数：展示数据的辅助参数，包括标题的位置居中左对齐，图例的是否显示和显示位置；这类参数在同一系统中都是固定的，所以无需每次调用都传入；使用简化映射的方式，将此类参数定义在封装程序中；封装程序首先检测是否外部传入参数，传入则使用外部参数覆盖默认参数，没传入继续使用默认参数，将合并之后的样式参数解析成原生的echarts参数；

C、功能模块参数：echarts提供一些功能性的模块，有数据视图、放大、保存图片；

封装程序将这些模块封装在内部并定义一些默认的参数；外部传入数组的形式，如果只是开启模块，只需传入一个相对应的字符key值，封装逻辑根据传入的key值加载默认的参数；如果需要使用非默认配置来开启模块，则需传入完整的原生模块参数，封装模块将这两部分的参数解析合并成原生的参数；

D、不常用的参数：这些参数或只需使用echarts原生的默认值，或是内部使用固定的值去定义，需要改变的时候才在外部传入；不常用的参数采用不一样的映射解析方式；采用“层次1_层次2:{原生参数}”这种形式去定义，封装程序判断是否传入了不常用参数，如果传入了根据不常用参数的key值解析出的正确原生层次关系，那么将不常用参数合并到已经完成解析的原生的echarts参数当中。