Apache Echarts 自学笔记 7. 概念篇 - 【数据集】 7.5 维度（dimension）

蔚落 2024-03-26 14:43 33阅读 0赞

#### Apache Echarts 自学笔记 ####

#### 文章目录 ####

*   *   *  Apache Echarts 自学笔记
         *   *  7. 概念篇 - 【数据集】
             *   *  7.5 维度（dimension）

> 学习资料：【Echarts官网：https://echarts.apache.org/】
> 
> ![在这里插入图片描述][eebd56c67a364abdad52615e65368076.png_pic_center]
> 
> 如侵立删

##### 7. 概念篇 - 【数据集】 #####

###### 7.5 维度（dimension） ######

常用图表所描述的数据大部分是“二维表”结构，之前的例子中，我们都使用二维数组来容纳二维表。

现在，当我们把系列（series）对应到“列”的时候，那么每一列就称为一个“维度（dimension）”，而每一行称为数据项（item）。反之，如果我们把系列（series）对应到表行，那么每一行就是“维度（dimension）”，每一列就是数据项（item）。

维度可以有单独的名字，便于在图表中显示。维度名（dimension name）可以在定义在 dataset 的第一行（或者第一列）。例如上面的例子中，

`'score'`、`'amount'`、`'product'` 就是维度名。从第二行开始，才是正式的数据。`dataset.source` 中第一行（列）到底包含不包含维度名，ECharts 默认会自动探测。当然也可以设置 `dataset.sourceHeader: true` 显示声明第一行（列）就是维度，或者 `dataset.sourceHeader: false` 表明第一行（列）开始就直接是数据。

维度的定义，也可以使用单独的 `dataset.dimensions` 或者 `series.dimensions` 来定义，这样可以同时指定维度名，和维度的类型（dimension type）：

var option1 = {
        
      dataset: {
        
        dimensions: [
          {
         name: 'score' },
          // 可以简写为 string ，表示 dimension name 。
          'amount',
          // 可以在 type 中指定维度类型。
          {
         name: 'product', type: 'ordinal' }
        ],
        source: [
          //...
        ]
      }
      // ...
    };
    
    var option2 = {
        
      dataset: {
        
        source: [
          // ...
        ]
      },
      series: {
        
        type: 'line',
        // series.dimensions 会更优先于 dataset.dimension 采纳。
        dimensions: [
          null, // 可以设置为 null 表示不想设置维度名
          'amount',
          {
         name: 'product', type: 'ordinal' }
        ]
      }
      // ...
    };

大多数情况下，我们并不需要去设置维度类型，因为 ECharts 会自动尝试判断。但是如果不足够准确时，可以手动设置维度类型。

维度类型（dimension type）可以取这些值：

*  `'number'`: 默认，表示普通数据。
 *  `'ordinal'`: 对于类目、文本这些 string 类型的数据，如果需要能在数轴上使用，须是 ‘ordinal’ 类型。ECharts 默认会试图自动判断这个类型。但是自动判断也可能不准确，所以使用者也可以手动强制指定。
 *  `'time'`: 表示时间数据。设置成 `'time'` 则能支持自动解析数据成时间戳（timestamp），比如该维度的数据是 ‘2017-05-10’，会自动被解析。如果这个维度被用在时间数轴（[axis.type][] 为 `'time'`）上，那么会被自动设置为 `'time'` 类型。时间类型的支持参见 [data][]。
    
    ![在这里插入图片描述][5f6272e6c2ab4d7698cbb64b90a34e90.png_pic_center]
 *  `'float'`: 如果设置成 `'float'`，在存储时候会使用 `TypedArray`，对性能优化有好处。
 *  `'int'`: 如果设置成 `'int'`，在存储时候会使用 `TypedArray`，对性能优化有好处。

[eebd56c67a364abdad52615e65368076.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/78b33e1d182044c9b5d6ab0ac4c22f68.png
[axis.type]: https://echarts.apache.org/option.html#xAxis.type
[data]: https://echarts.apache.org/option.html#series.data
[5f6272e6c2ab4d7698cbb64b90a34e90.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/071acc2d27334e7296d6ebd6f7b9cf3f.png