mmecharts.js
echarts 数据、样式配置分离,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 {};
}
}
例子
原文发布时间为:2018年02月27日
原文作者:parky_18
本文来源:开源中国 如需转载请联系原作者