echart4数据管理组件dataset学习

背景

如果后台数据固定，如何动态定制其前端数据展示方式呢？也就是说同一种数据，如何被多个前端Echarts图表复用呢？最近在研究一种数据展示可配置化的功能，然后发现了echart4.0的dataset组件或许可以实现该需求。

dataset组件介绍

ECharts 4 开始支持了 dataset

组件用于单独的数据集声明，从而数据可以单独管理，被多个组件复用，并且可以基于数据指定数据到视觉的映射。这在不少场景下能带来使用上的方便。

ECharts 4 提供了数据集（dataset）组件来单独声明数据，它给后端开发人员带来的便捷之处有：

更专注数据，而非前端数据转换（之前版本需要定制series的各项配置）
数据和其他配置可以被分离开来
数据可以被多个系列或者组件复用，即一份数据可配置多种展示形式

dataset常见数据格式

第一种，二维数据表格式，示例：



dataset: {

        // 提供一份数据：二维数组

        source: [

            ['product', '2015', '2016', '2017'],

            ['Matcha Latte', 43.3, 85.8, 93.7],

            ['Milk Tea', 83.1, 73.4, 55.1],

            ['Cheese Cocoa', 86.4, 65.2, 82.5],

            ['Walnut Brownie', 72.4, 53.9, 39.1]

        ]

    },

这里的source就是数据源，二维数组格式的数据，第一行可以理解为数据列名称，后面几行是表的数据。这本质上就是数据库表的样子，我在数据库中创建一张表，数据与上述demo完全一致，如图：

第二种，JSON数组形式，即将数据库中表的数据转换为JSON对象数组：



dataset: {

        // 这里指定了维度名的顺序，从而可以利用默认的维度到坐标轴的映射。

        // 如果不指定 dimensions，也可以通过指定 series.encode 完成映射，参见后文。

        dimensions: ['product', '2015', '2016', '2017'],

        source: [

            {product: 'Matcha Latte', '2015': 43.3, '2016': 85.8, '2017': 93.7},

            {product: 'Milk Tea', '2015': 83.1, '2016': 73.4, '2017': 55.1},

            {product: 'Cheese Cocoa', '2015': 86.4, '2016': 65.2, '2017': 82.5},

            {product: 'Walnut Brownie', '2015': 72.4, '2016': 53.9, '2017': 39.1}

        ]

    },

这种形式的数据，其source就是JSON数组，没有了标题信息，所以需要借助dimensions或者encode等配置来指导前端图表完成渲染动作。

使用原理

数据到图形的映射的逻辑是这样的：基于数据，在配置项中指定如何映射到图形：

概略而言，可以进行这些映射：

1、指定 dataset 的列（column）还是行（row）映射为图形系列（series）。这件事可以使用 series.seriesLayoutBy 属性来配置。默认是按照列（column）来映射。

2、指定维度映射的规则：如何从 dataset 的维度（一个“维度”的意思是一行/列）映射到坐标轴（如 X、Y 轴）、提示框（tooltip）、标签（label）、图形元素大小颜色等（visualMap）。这件事可以使用 series.encode 属性，以及 visualMap 组件（如果有需要映射颜色大小等视觉维度的话）来配置。

以上述表为例，主要是解决X轴和Series的名称及数据的映射过程：

即解答上图横向的一组名称和纵向的一组名称，谁作为X轴，谁作为Series的问题。

默认情况下是将纵向的一列数据作为一个Series的数据，那么纵向的第一列的的值就是X轴的名称了（即纵向框的三个值），一列为一个Series，那么除第一列外，所有的列名的集合是Series的名称集合了（即横向框的四个值）。

映射过程就是决定一个Series的数据是取横向的行数据，还是纵向的列数据，纵横两个方向分别确定X轴类目和Series的图例。

官网demo理解

官网提供了一个同时映射到列和行的demo例子：



option = {

    legend: {},

    tooltip: {},

    dataset: {

        source: [

            ['product', '2012', '2013', '2014', '2015'],

            ['Matcha Latte', 41.1, 30.4, 65.1, 53.3],

            ['Milk Tea', 86.5, 92.1, 85.7, 83.1],

            ['Cheese Cocoa', 24.1, 67.2, 79.5, 86.4]

        ]

    },

    xAxis: [

        {type: 'category', gridIndex: 0},

        {type: 'category', gridIndex: 1}

    ],

    yAxis: [

        {gridIndex: 0},

        {gridIndex: 1}

    ],

    grid: [

        {bottom: '55%'},

        {top: '55%'}

    ],

    series: [

        // 这几个系列会在第一个直角坐标系中，每个系列对应到 dataset 的每一行。

        {type: 'bar', seriesLayoutBy: 'row'},

        {type: 'bar', seriesLayoutBy: 'row'},

        {type: 'bar', seriesLayoutBy: 'row'},

        // 这几个系列会在第二个直角坐标系中，每个系列对应到 dataset 的每一列。

        {type: 'bar', xAxisIndex: 1, yAxisIndex: 1},

        {type: 'bar', xAxisIndex: 1, yAxisIndex: 1},

        {type: 'bar', xAxisIndex: 1, yAxisIndex: 1},

        {type: 'bar', xAxisIndex: 1, yAxisIndex: 1}

    ]

}

最终展现的效果图为:

第一个坐标轴将Series映射到行数据上，行数就是Series数，转换过程：



	维度：[Matcha Latte,Milk Tea,Cheese Cocoa]，三个（行数）

	item:四列，每一列三项数据，对应三个Series（列数-1）

	X轴：四列，与列数一致[2012,2013,2014,2015]（列数）

	Series:[Matcha Latte,Milk Tea,Cheese Cocoa]，三个（行数）

	图例：与Series的name一致（行数）

图表以行作为维度展示的，Series就是每一行的第一列数据（即产品名称），表示每一年各产品的数值的对比图。

第二个坐标将Series映射到列上，列数就是Series数：



    维度：[2012,2013,2014,2015]，四个（列数）

    item:三个，每一行四项数据对应四个Series，总共3个item（行数）

    X轴：三个，与行数一致[Matcha Latte,Milk Tea,Cheese Cocoa]（行数）

    Series:[2012,2013,2014,2015]，四个（列数）

    图例：与Series的name一致（列数）

图表以列作为维度展示的，Series就是第一列数据（即产品名称），表示每个产品各年的数值的对比图。

启示录

默认的映射规则就是常规思维，图表展示的数据与数据库表存储的数据表达的含义一致：每种产品每一年的数值，此时Series是年份，Series的总数是总列数-1，第一列作为横轴映射值了，不计入Series总数。

总的来说，还是有一点绕的。

来源：https://blog.csdn.net/wojiushiwo945you/article/details/86527721