ECharts 折线图

这个小节开始我们开始学习 ECharts 中的各个图形，这些图形都有着自己独特的风格，有着自己更适合的场景，在合理的场景下选择更为合适的图才能让我们的数据更好展示与分析。本节我们就先讲折线图这个稍微简单的图形。折线图用于显示数据在一个连续的时间间隔或者时间跨度上的变化，它的特点是反映事物随另一维度数值变化所产生趋势。

1. 简介

官方定义：

折线图是用折线将各个数据点标志连接起来的图表，用于展现数据的变化趋势。可用于直角坐标系和极坐标系上。

慕课解释

折线图是用直线将一系列的数据点连接的图表，可以显示随维度 x 变化而变化的 y 数据，适合用于显示在相同 x 间隔下，数据的变化趋势。ECharts 的提供的折线图功能非常完备，可通过配置项的 series 属性传入 type = line 的对象完成配置。

折线图配置项繁多，官网对此已有详尽介绍，在此不赘述。下面会提供丰富的示例，详尽介绍折线图的方方面面。

2. 实例解说

2.1 基础示例

在 echarts 中，通过传入 xAxis、yAxis、series 三个关键属性，即可完成一个折线图的配置，示例：

示例效果：

图片描述

示例代码有几个关键点：

需要传入 xAxis 显式声明 x 轴状态，示例中通过 type: category 将该轴配置为类目轴，并通过 data 属性显式定义该轴下的类目数据；
需要传入 yAxis 显式声明 y 轴状态，示例中通过 type: value 将盖州配置为类目轴；
折线图通过配置项的 series 传入，且必须声明 type: line。示例中通过 data 属性声明了该图表的系列数据。

实际应用中，我们常常会忽略类目轴的 data 配置，而交由 echarts 自行推断，下例代码可以实现与上例相同的效果：

2.2 双轴折线图

有时候，需要在一个图表上显示多个系列的数据，但如果数据之间的范围偏差比较大，较小的部分就可能会被拉伸到接近直线，丢失了变化趋势的表达能力，例如：

图片描述

图中，红色系列的数据为 [820, 932, 901, 934, 1290, 1330, 1320]，但因为蓝色系列的数值过大：[14080, 13800, 12380, 15860, 13380, 14900, 15108]，使得折线图上表现得接近一条水平线。此时，可通过设置两个 y 轴，让坐标轴呈现的数值范围更接近于真实数据范围，示例：

图片描述

相比于第一张图，新的折线图更能传达出数据变化的趋势。从代码看，一是需要在 yAxis 配置上传入两个配置项；二是需要在 series 配置上，指明序列对应的 yAxisIndex 属性，以区分序列所对应的的坐标轴。

除了拆分坐标轴外，也可以选择拆分整个坐标系，画成两个不同的图表：

示例效果：

图片描述

示例中，grid、xAxis、yAxis 均声明了两份配置，从而拆分出两个分离的坐标系，这种表现方法可以在有限的面积内清晰表现出多份关联数据，日常开发中经常会用到。

3. 配置详解

3.1 data 数据配置项详解

data 属性用于配置折线图的数据集，上面例子已经给出一些示例。data 项的常见形态有：

空值：当某数据不存在时，可以用 ‘-’、null、undefined、NaN 表示；
二维数组 ：数组项用一个二维数组表示： [x, y]，在直角坐标系中对应 [x值, y值]；在极坐标系中对应 [距离, 角度]；

一维数组 ：数组项用一个数字表示，通常见于直角坐标系上某一轴为类目轴的场景。 data 值与 axis 值按顺序一一对应，例如：

{
"xAxis": {
    "type": "category",
    "data": ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
},
"series": [
    {
        // 对应顺序：
        //       Mon  Tue  Wed  Thu  Fri   Sat   Sun
        "data": [820, 932, 901, 934, 1290, 1330, 1320]
    }
]

}

对象：数组项用一个对象表示，例如：

{
"xAxis": { "type": "category" },
"data": [
    { "name": "Mon", "value": 820 },
    { "name": "Tue", "value": 932 },
    { "name": "Wed", "value": 901 },
    { "name": "Thu", "value": 934 },
    { "name": "Fri", "value": 1290 },
    { "name": "Sat", "value": 1330 },
    { "name": "Sun", "value": 1320 }
]

}

当数组项为对象时，除 name、value 属性外还可以传入 symbol、label 等配置项实现针对数据项级别的定制化，例如：

示例效果：

图片描述

3.2 symbol 配置详解

symbol 用于描述图表上点的绘制方法，对应下图红色圆点部分：

图片描述

在 ECharts 上，symbol 可通过如下配置项描述：

配置名	类型	默认值	说明
showSymbol	boolean	true	控制是否显示 symbol，如果 false 则只有在 tooltip hover 的时候显示。
showAllSymbol	boolean	string	auto
symbol	string	function	emptyCircle
symbolSize	number	array	function
symbolRotate	number	0	标记的旋转角度
symbolKeepAspect	boolean	true	如果 symbol 是 `path://` 形式，是否在缩放时保持该图形的长宽比。
symbolOffset	array	[0, 0]	标记相对于原本位置的偏移

通过上述配置，可以改变图表上点的表现形式，接下来就表中关键事项展开示例。

3.2.1 使用预设标记图形

默认的，ECharts 会使用空心圆绘制标记点，如上一节示例图所示。除空心圆外，ECharts 还准备了几个开箱即用的标记图形选项，完整列表包括：

emptyCircle ：空心圆
circle ：实心圆
rect ：正方形
roundRect ：圆角正方形
triangle ：三角形
diamond ：棱形
pin ：水滴
arrow ：箭头
none ：无图形，形如设置 showSymbol:false

各选项对应的展示效果如下：

图片描述

3.2.2 使用自定义标记

除预设的图形集合外，echarts 支持自定义标记图形，同样通过 symbol 属性定义，支持传入 3 种值：

支持 image://http://xxx/xxx.png 格式，传入标记图形的 URL；
支持 image://data:image/png;base64,ixxx 格式，传入标记图形的 Base64 值；
支持 path://M30.9,53.2C16.8... 格式，传入标记图形的 svg 路径值。

示例：

示例效果：

图片描述

3.2.3 控制显示

当类目轴上数据太多时，可能导致标记的展示特别拥挤，ECharts 就此提供了 showAllSymbol 配置项，该项接受如下值：

auto ：默认值，如果有足够空间则显示标志图形，否则随主轴标签间隔隐藏策略；
true ：显示所有图形；
false ：随主轴标签间隔隐藏策略。

示例：

示例效果：

图片描述

对比可知，左图 showAllSymbol = true 时，显示所有标记图形，略显拥挤；右图 showAllSymbol = false，则随主轴标记隐藏而隐藏。

3.3 label 配置详解

label 项用于配置折线图点上的文本标签，支持显示点的系列名、数据名、数据值以及其他自定义信息。与 tooltip 不同，label 显示的文本信息与折线上的点强相关，通常配置在点的附近显示，例如：

示例效果：

图片描述

3.3.1 配置标签位置

可通过如下配置项设定标签的显示位置：

配置名	类型	默认值	说明
position	string	array	top
distance	number	5	标签与坐标点的距离，仅当 position 为字符串选项值时有效
rotate	number		标签选择角度
offset	array	[0, 0]	标签距离默认位置的偏移值

其中， position 支持数组如 [10, 30] 用于指定像素位置值，或如 [10%, 20%] 用于指定百分比位置值。此外，还支持如下枚举值：

top
left
right
bottom
inside
insideLeft
insideRight
insideTop
insideBottom
insideTopLeft
insideBottomLeft
insideTopRight
insideBottomRight

枚举值对应位置如图：

图片描述

position 属性决定了标签的大致位置，之后可以通过配置其他位置属性做出微调，如下示例：

示例效果：

图片描述

3.3.2 配置标签内容

可通过 label.formatter 属性修改折线图标签内容，支持模板字符串与回调函数两种形式。模板字符串支持如下变量：

{a}：系列名；
{b}：数据名；
{c}：数据值。
{@xxx}：数据中名为’xxx’的维度的值，如{@product}表示名为 ‘product’ 的维度的值；
{@[n]}：数据中维度 n 的值，如 {@[3]} 表示维度 3 的值，从 0 开始计数。

标签内容默认只展示数据值，相当于 {c}。模板字符串方式的配置相对来说更加清晰简单，例如：

示例效果：

图片描述

回调函数方式支持传入格式化函数，函数将收到当前数据项的描述对象作为参数，形如：

{
    componentType: 'series',
    // 系列类型
    seriesType: string,
    // 系列在传入的 option.series 中的 index
    seriesIndex: number,
    // 系列名称
    seriesName: string,
    // 数据名，类目名
    name: string,
    // 数据在传入的 data 数组中的 index
    dataIndex: number,
    // 传入的原始数据项
    data: Object,
    // 传入的数据值。在多数系列下它和 data 相同。在一些系列下是 data 中的分量（如 map、radar 中）
    value: number|Array|Object,
    // 坐标轴 encode 映射信息，
    // key 为坐标轴（如 'x' 'y' 'radius' 'angle' 等）
    // value 必然为数组，不会为 null/undefied，表示 dimension index 。
    // 其内容如：
    // {
    //     x: [2] // dimension index 为 2 的数据映射到 x 轴
    //     y: [0] // dimension index 为 0 的数据映射到 y 轴
    // }
    encode: Object,
    // 维度名列表
    dimensionNames: Array<String>,
    // 数据的维度 index，如 0 或 1 或 2 ...
    // 仅在雷达图中使用。
    dimensionIndex: number,
    // 数据图形的颜色
    color: string,

}

函数方式更灵活，适合用于描绘复杂标签的场景，例如计算系列上每个节点数值在整个系列的百分比，示例：

示例效果：

图片描述

4. 个人经验

折线图形式简单，内容清晰，简明易懂，经常用于表达数据序列的 连续变化 ，例如 UV/PV 趋势、流量变化、活跃度等，在实战中使用的频率比较高。echarts 的折线图提供了丰富的配置项，基本上能够覆盖日常大多数场景，甚至可以说，当你觉得无法满足需求的时候，不妨回过头来看看配置问题，或许某个配置项上的小改动，就能解决问题。

echarts 的折线图提供了大量的配置，学习过程中需要多尝试，仔细阅读文档，多对比配置项不同值的效果的效果。

比如这样一个问题，当数据序列的数值离散程度低，表现得可能会接近一条直线，考虑数值序列 [10444, 10484, 10984, 10975, 10264, 10088, 10822, 10046, 10708, 10514]，在默认情况下，表现如下：

图片描述

解决问题先要理解问题症结，可以看到 y 坐标轴上预留了大量的空间留给 0 - 10000 数值范围，导致真正表现数据的 10000 - 11000 反而占据的空间很小。解决方法是适当设置 yAxis.min 属性，用序列数值来推断最小值，例如：

图片描述

这样看起来就顺眼多了。

5. 小结

图片描述
本节结合实例讲述 Echarts 折线图的功能特性，包括基础配置方法；如何实现双轴折线图；如何实现极坐标折线图；以及折线图中其他配置属性的详细讨论。