mmecharts.js
echarts3.x 数据、样式配置分离,jquery组件 项目地址:https://gitee.com/parki/mmecharts 1、同一份数据用在不同图表类型 2、自动解析不同数据结构 3、只修改需要修改的配置
##目录
概述
echarts3.x 数据、样式配置分离,jquery组件
1、同一份数据用在不同图表类型 2、自动解析不同数据结构 3、只修改需要修改的配置
用法
导入jquery.js和mm.echarts.js和echarts.js
$(function () { $(selector).mmEcharts(options); });
Options
| 名称 | 标签 | 类型 | 默认 | 描述 |
| chartType | data-chart-type | string | line | 图表类型;line:折线图,bar:柱状图,bar2:x轴和y轴调换的柱状图,pie:饼状图,map:地图 |
| queryUrl | data-query-url | string | undefined | 请求后台数据URL |
| queryParams | data-query-params | object | undefined | 请求后台参数 |
| ajax | 不支持 | object | undefined | ajax请求配置 |
| dataType | data-data-type | string | row | 请求后台返回数据类型,row或者column |
| chartTheme | data-chart-theme | string | walden | 图表主题 |
| chartOptions | data-chart-options | object | undefined | 图表配置,可以只设置修改部分,会和默认配置合并 |
| groupField | data-group-field | string | name | 数据解码,分组字段 |
| valueFields | data-value-fields | object | undefined | 数据解码,值字段,如,显示两条线:valueFields:{'dayValue':'日活完成量','monthTarget':'日活目标按月分解'} |
| categoryField | data-category-field | string | name | 类目字段,从行数据中获取,则需要配置该字段,如果设置categoryField则不需要设置valueFields |
| categoryValueField | data-category-value-field | string | name | 如果出现categoryField字段,必须要有categoryValueField字段 |
| dataset | 不支持 | object | undefined | 设置图表数据 |
事件
| 名称 | 标签 | 参数 | 描述 |
| on | 不支持 | 事件配置,{on:{click:function(){},mouserover:function(){};另外还支持事件:before:配置开始;renderBefore:后台数据已经返回开始渲染;complete:渲染完成 | |
| before | data-before | MMChart | 配置开始 |
| renderBefore | data-render-before | data, params, MMChart | 后台数据已经返回开始渲染 |
| complete | data-complete | MMChart | 渲染完成 |
MMChart方法
| 名称 | 参数 | 描述 |
| loadDataByUrl | url, params, dataType, defaultOptions, callback | 通过URL加载数据 |
| addChartBySql | options, chartType, yAixs, sql, params, dataType, callback | 添加混合图形 |
| addChartByData options, chartType, yAixs, data, dataType, callback | 添加混合图形 | |
| echarts | none | 获得echarts对象 |
| setEchartsOption | options | 设置echarts配置 |
| getEchartsOption | none | 获取echarts配置 |
| setOptions | options | 设置MMChart配置 |
| getOptions | none | 获取MMChart配置 |
ChartType方法
| 名称 | 参数 | 描述 |
| type | 属性 | 图表类型 |
| option | defaultOption | 图表默认配置 |
| decodeData | data,MMChart | 解码数据 |
自定义扩展图表类型
默认支持图表类型,line,bar ,bar2,map,pie.可以通过扩展ChartType增加图表类型。 可以参考examples\mm.echarts.radar.js,代码结构:
$.mmEcharts.chartType.radar={ //扩展的图表名称 type: '图表类型', //默认通用配置 option: function () { return {}; }, /** * 把数据解码对应的series * @param data 数据 * @param mmChart * @returns {echarts.options} */ decodeData: function (data,mmChart){ return {}; } }
例子
图表例子
折线图例子
柱状图例子
饼状图例子
混合图形例子 自定义扩展图表例子