dg-chart-options
功能:自定义图表选项,比如是否显示标题、是否显示图例、图例位置、坐标轴位置等等。
必填:否
元素:<body>、<div>图表元素。 当在<body>元素设置时,可定义全局图表选项;当在<div>图表元素设置时,仅定义单个图表选项,图表元素级设置将会继承全局设置。
格式:{ … }
系统内置的各类图表选项格式说明如下表所示:
图表类型 | 选项说明 |
---|
折线图、柱状图、饼图、仪表盘、 散点图、雷达图、漏斗图、地图、 K线图、热力图、树图、旭日图、 桑基图、关系图 | ECharts官方图表,图表选项参考ECharts官方文档配置项手册 |
词云图 | ECharts扩展图表,图表选项参考echarts-wordcloud项目说明文档 |
水球图 | ECharts扩展图表,图表选项参考echarts-liquidfill项目说明文档 |
表格 | HTML图表,图表选项如下所示:{ title: //标题 { show: true, //是否显示 text: “…” //自定义标题文本 color: ‘…’, backgroundColor: ‘…’”, … //其他CSS样式 },
table: { header: //表头 { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 }, row: //行 { color: ‘…’, … //其他CSS样式 odd: //偶数行 { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 }, even: //奇数行 { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 }, hover: //鼠标悬浮行样式 { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 }, selected: //选中行样式 { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 } }, //自定义单元格渲染函数 //value 单元格值 //name 单元格列名 //rowIndex 单元格行索引 //columnIndex 单元格列索引 //row 单元格所在的行数据对象 renderValue: function(value, name, rowIndex, columnIndex, row) { return “…”; } },
//表格轮播设置项 carousel: //开启、禁用轮播 true、false、 //开启轮播,并设置滚动间隔毫秒数 数值、 //开启轮播,并设置返回滚动间隔毫秒数的函数 function(tr, visibleHeight, height){ return …; }、 //轮播详细设置 { //是否开启 enable: false, //滚动间隔毫秒数,或者返回滚动间隔毫秒数的函数: //tr 当前顶部可见行DOM元素 //visibleHeight 当前顶部可见行的剩余可见高度 //height 当前顶部可见行总高度 //function(tr, visibleHeight, height){ return …; } interval: 50, //滚动跨度像素数,或者返回跨度像素数的函数: //function(tr, visibleHeight, height){ return …; } span: 1, //是否在鼠标悬停时暂停轮播 pauseOnHover: true },
//固定列配置项 fixedColumns: { //固定左侧列数 leftColumns: 1, //固定右侧列数 rightColumns: 1 },
//客户端分页配置项:true 开始;false 禁用 paging: false }
表格图表底层采用了DataTable组件,更多配置项参考DataTable配置项说明文档 |
标签卡 | HTML图表,图表选项如下所示:{ label: { //标签名样式 name: { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 }, //标签值样式 value: { color: ‘…’, backgroundColor: ‘…’, … //其他CSS样式 } } }
|
示例:
<head>
<script type="text/javascript">
var myChartOptions={ title: {show: false } };
</script>
</head>
<body dg-chart-options="{legend:{left:0}}">
<div dg-chart-widget="..." dg-chart-options="{title:{show:false},legend:{top:0},grid:{top:40}}"></div>
<div dg-chart-widget="..." dg-chart-options="myChartOptions"></div>
</body>
另外,所有内置图表都支持如下配置项:
processRenderOptions: function(renderOptions, chart){ … }
用于在图表渲染前处理配置项。
processUpdateOptions: function(updateOptions, chart, results){ … }
用于在图表更新数据前处理配置项。
示例:
<head>
<script type="text/javascript">
var myChartOptions=
{
processRenderOptions: function(renderOptions, chart)
{
...
},
processUpdateOptions: function(updateOptions, chart, results)
{
...
}
};
</script>
</head>
<body>
<div dg-chart-widget="..." dg-chart-options="myChartOptions"></div>
</body>
如果仅想设置图表配色,则可使用更便捷的dg-chart-theme属性。