2.4　学会使用ECharts官方文档

在学习一门技术时，官方文档是一个系统的学习资源，但是对于基础水平参差不齐的学习者来说，很多技术的官方文档并不能做到因人而异。本书的初衷之一就是帮助大家从入门ECharts到使用官方文档来进阶ECharts。让我们马上行动起来吧！

首先，ECharts的官网的菜单栏“文档”选项中包含几个部分，如图2-16所示。

图2-16　ECharts的官方文档入口

当打开“特性”页面时，会显示ECharts的优秀特性介绍，其中部分特性已经在第1章有过相关介绍。

当打开“教程”页面时，可以看到ECharts的部分教程。但这部分内容较少，所以这也是我写本书的初衷之一。

当打开“API”页面时，可以看到很多具体的实例和方法，帮助我们使用ECharts完成各种功能。建议将这部分内容当作字典来查阅。

当打开“配置项手册”页面时，会发现这里的内容非常多，涉及各种构图元素，例如标题、背景色、图例、绘图数据等，之后的章节会详细介绍这些配置项，包括如何使用配置项增加图中元素和功能，如何调整配置项让显示的内容更合适等。

当打开“GL配置项手册”页面时，发现这是和ECharts绘制3D内容相关的配置项。

当打开“版本记录”页面时，可以看到这里记录了ECharts的版本更新，但是这里只记录了3.0.0版本之后的版本，而3.0.0之前的版本记录需要在其他页面查看。当我们点击任意一个版本记录时，可以看到该版本具体做了什么，例如增加了功能或者优化了性能等。

在菜单栏的“资源”选项中，为“术语速查手册”。当打开“术语速查手册”页面时，可以看到它提供了这样一个功能：当用户的鼠标悬停在图表的某个元素上时，右边会出现该元素是由哪个具体的配置项组成的。例如，当鼠标悬停在x轴的坐标文字上时，右边显示“坐标轴刻度标签”，并给出配置的具体参数，如图2-17所示。

图2-17　术语速查手册

除此之外，该页面还提供了各种类型图、坐标系、组件的文档速查链接，如图2-18所示。当你点击想要查询的内容时，会跳转到具体的配置项页面。

图2-18　速查快捷引导