1.安装ECharts环境:
ECharts提供了多种安装方式,可以根据需要选择以下任意一种方式安装,具体内容可以参看官方文档。
本次从jsDelivr CDN
上获取,快速安装。
在https://www.jsdelivr.com/package/npm/echarts页面选择需要的版本,然后选择/dist
,点击并保存为echarts.js
文件,也可以选择echarts.min.js
文件,两者的区别如下所示:
echarts.js
源码版本文件较大,包含了常见的错误提示和警告,会在调试时反馈错误信息,主要在调试本地ECharts图表时使用;echarts.min.js
文件较小,不会反馈错误信息,主要在调试完成后在网页展示时使用,这样网页加载速度会更快。
另外,也可以在 ECharts 的官网上直接下载更多丰富的版本,包含了不同主题跟语言,打开官方下载页面,在方法一:从下载的源代码或编译产物安装
中选择需要的版本点击后,跳转到具体下载页面,点击链接下载即可。
2.构建ECharts图表:
2.1 引入ECharts的js文件
新建一个index.html
文件,在同一目录下新建一个js
文件夹,并将echarts.js
文件放在该文件夹下。
代码如下:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<!-- 引入下载的 echarts.js 文件 -->
<script src="js/echarts.js"></script>
</head>
</html>
2.2 创建一个容器DOM
在绘图前需要为 ECharts 准备一个定义了高宽的 DOM 容器,用于显示图表。在index.html
中的</head>
部分添加如下代码:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<!-- 引入下载的 echarts.js 文件 -->
<script src="js/echarts.js"></script>
</head>
<body>
<!-- 为 ECharts 准备一个定义了宽高的 DOM -->
<div id="main" style="width: 600px;height:400px;"></div>
</body>
</html>
2.3 初始化ECharts实例
通过echarts.init
方法初始化一个 echarts 实例,代码如下:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<!-- 引入下载的 echarts.js 文件 -->
<script src="js/echarts.js"></script>
</head>
<body>
<!-- 为 ECharts 准备一个定义了宽高的 DOM -->
<div id="main" style="width: 600px;height:400px;"></div>
<script type="text/javascript">
// 基于准备好的dom,初始化echarts实例
var myChart = echarts.init(document.getElementById('main'));
</script>
</body>
</html>
2.4 设置图表的参数
这一步是核心内容,代码如下所示,具体参数后续会一一介绍,本次只需了解构建ECharts图表的一般流程即可。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<!-- 引入下载的 echarts.js 文件 -->
<script src="js/echarts.js"></script>
</head>
<body>
<!-- 为 ECharts 准备一个定义了宽高的 DOM -->
<div id="main" style="width: 600px;height:400px;"></div>
<script type="text/javascript">
// 基于准备好的dom,初始化echarts实例
var myChart = echarts.init(document.getElementById('main'));
// 指定图表的配置项和数据
var option = {
title: {
text: 'ECharts图表示例'
},
tooltip: {},
legend: {
data: ['销量']
},
xAxis: {
data: ['品类1', '品类2', '品类3', '品类4', '品类5', '品类6']
},
yAxis: {},
series: [{
name: '销量',
type: 'bar',
data: [5, 20, 36, 10, 10, 20]
}]
};
</script>
</body>
</html>
2.5 显示图表
通过myChart.setOption(option)
用指定的配置项和数据显示图表,代码如下:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<!-- 引入下载的 echarts.js 文件 -->
<script src="js/echarts.js"></script>
</head>
<body>
<!-- 为 ECharts 准备一个定义了宽高的 DOM -->
<div id="main" style="width: 600px;height:400px;"></div>
<script type="text/javascript">
// 基于准备好的DOM,初始化ECharts实例
var myChart = echarts.init(document.getElementById('main'));
// 指定图表的配置项和数据
var option = {
title: {
text: 'ECharts图表示例'
},
tooltip: {},
legend: {
data: ['销量']
},
xAxis: {
data: ['品类1', '品类2', '品类3', '品类4', '品类5', '品类6']
},
yAxis: {},
series: [{
name: '销量',
type: 'bar',
data: [5, 20, 36, 10, 10, 20]
}]
};
// 使用指定的配置项和数据显示图表。
myChart.setOption(option);
</script>
</body>
</html>
至此ECharts图表构建完成,使用浏览器打开index.html
文件可以看到如下图表:
通过上述步骤可以看出构建ECharts图表的一般步骤:
- 引入ECharts的js文件;
- 创建一个容器DOM;
- 初始化ECharts实例;
- 设置图表的参数(核心内容);
- 显示图表。
3.ECharts相关资源网站:
学习ECharts时,官方文档是最好的学习资源。
- EChatrts官网:https://echarts.apache.org/zh/index.html
- EChatrts配置手册:https://echarts.apache.org/zh/option.html#title
- EChatrts官方示例:https://echarts.apache.org/examples/zh/index.html
- EChatrts社区:https://www.makeapie.com/explore.html
- brewer调色板介绍:http://mkweb.bcgsc.ca/brewer/
- brewer调色板的地图显示效果:https://colorbrewer2.org/
- 颜色工具:http://tools.jb51.net/static/colorpicker/