New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

从echarts2升级到echarts3需要做什么修改 #3322

Open
huang-x-h opened this Issue Jun 1, 2016 · 17 comments

Comments

Projects
None yet
10 participants
@huang-x-h

huang-x-h commented Jun 1, 2016

问题简述 (One-line summary)

没有看到关于 echarts2 升级到 echarts3 说明,如果要升级需要做什么修改?以及相关 api 接口有做修改吗?

@pissang pissang added the question label Jun 1, 2016

@pissang

This comment has been minimized.

Show comment
Hide comment
@pissang

pissang Jun 1, 2016

Contributor

还没有统一的说明文档,这里简单列一下,如果有问题可以在这个 issue 下继续说明

1. 引入方式简化

2 中打包的文件内置了 esl 模块加载器,所以引入 echarts 就强制引入了一个 AMD 的环境,3 中对这点做了改进,打包文件是 UMD 规范的,可以 requirejs 引入,或者直接标签式引入,如果是 npm 安装的话也可以直接用 CommonJS 的方式 require 引入,具体可见 5 分钟上手 ECharts在 webpack 中使用 ECharts

3 中构建好的文件也不再支持按需加载,因为像 2 那样尽管是按需加载,但是因为很多共用模块不得不放在 echarts.js 文件中,所以导致必须要加载的 echarts.js 文件很大(400k),而每个图表的文件又只有10几k,失去了按需加载的意义。所以 3 改为按需构建,可以在线构建,也可以通过 npm 安装,按需引入后用 webpack 构建。因为 3 的模块化更细粒度,所以最小需求的饼图可以做到构建出来只有 170k 左右。

2. 接口简化

首先是把数据驱动和声明式接口做得更加彻底了,所有数据项的改动和配置项的改动都统一使用 setOption 方法,有需要的话可以在这个方法基础上二次封装(比如定时更新数据的封装),不再有 addDatasetSeries等方法

其次是监听事件的简化,事件名称不再像 2一样需要引入 config 模块,而是都改成像 dom 事件一样的字符串,具体见 events 文档,需要注意的是,legend,地图等的选中事件名称都从 legendselected, mapselected 改为了 legendselectedchanged, mapselectedchanged,如下示例:

myChart.on('legendselectchanged', function () {} );

然后是不再像 2 那样通过组件暴露接口去实现程序实现数据区域选择等功能,而统一改为 dispatchAction 的方式,例如:

myChart.dispatchAction({
  type: 'dataZoom',
  start: 10,
  end: 20
});

这种方式可以使得所有行为的管理更加统一,而且不用暴露内部的代码组织。

可以参见文档 action

最后是联动 connect 的改动,见 http://echarts.baidu.com/api.html#echarts.connect

3. 地图数据不再内置

3 中对于地图数据精度提升了很多,地图体积也大了很多,再内置就不合适了,所以 3 中把所以地图数据外置了,但是对地图引入方式进行了大大的简化。可以直接引入一个地图的 js 文件,也可以引入地图的 json 文件后通过 registerMap 方法注册地图。

4. 配置项结构的改动

我们在 3 中尽力做到跟 2 配置项兼容,特别是折,柱,饼,散点,仪表盘,漏斗图等基础图表,有些配置项层级的改动,比如 label,areaStyle 等原先在 itemStyle 层级下的都移到了 series 层级下跟 itemStyle 同级,例如:

{
  label: { normal: { show: true } }
  itemStyle: { normal: {} }
}

这些小改动有许多,这里不一一列举了,当然这些改动都会做到向后兼容,原先的写法也依然能用,只是不再推荐。

5. 地图和关系图的改动

地图不再使用 markPoint 和 markLine 去画点和线的数据了,markPoint 和 markLine 的定位就是辅助标记,在 3 中有特定的 lines 类型绘制特定的线数据,点数据也可以使用地理坐标系上的散点图实现,见示例 全国主要城市空气质量

还有关系图绘制也是改动很大的一个地方,2 中的 force 图在 3 中不复存在,取而代之的是更加通用的 graph,在 graph 中可以应用更多的布局方法,除了 2 中的 force-directed 布局,也可以是环形布局,也可以预先布局好后存放到 x,y 属性中直接展现,也可以自己扩展布局,比如这个 echarts-dagre 扩展

6. 去掉了拖拽重计算,树图,和弦图,字符云,韦恩图

树图,字符云和韦恩图这三个图我们觉得在 2 中很不成熟,3 中对其优化改进前先暂时不支持,拖拽重计算我们觉得使用的人并不多,又会增加不少代码体积,所以也先去掉了,不排除后面会通过扩展的方式加入。

然后关于 3 的新特性,可以见文章 echarts 3 带来了什么,实际上这篇文章发布以来后的各个新版本我们又陆续加入了很多新特性。感兴趣的话可以看示例 和各个版本的 changelog

Contributor

pissang commented Jun 1, 2016

还没有统一的说明文档,这里简单列一下,如果有问题可以在这个 issue 下继续说明

1. 引入方式简化

2 中打包的文件内置了 esl 模块加载器,所以引入 echarts 就强制引入了一个 AMD 的环境,3 中对这点做了改进,打包文件是 UMD 规范的,可以 requirejs 引入,或者直接标签式引入,如果是 npm 安装的话也可以直接用 CommonJS 的方式 require 引入,具体可见 5 分钟上手 ECharts在 webpack 中使用 ECharts

3 中构建好的文件也不再支持按需加载,因为像 2 那样尽管是按需加载,但是因为很多共用模块不得不放在 echarts.js 文件中,所以导致必须要加载的 echarts.js 文件很大(400k),而每个图表的文件又只有10几k,失去了按需加载的意义。所以 3 改为按需构建,可以在线构建,也可以通过 npm 安装,按需引入后用 webpack 构建。因为 3 的模块化更细粒度,所以最小需求的饼图可以做到构建出来只有 170k 左右。

2. 接口简化

首先是把数据驱动和声明式接口做得更加彻底了,所有数据项的改动和配置项的改动都统一使用 setOption 方法,有需要的话可以在这个方法基础上二次封装(比如定时更新数据的封装),不再有 addDatasetSeries等方法

其次是监听事件的简化,事件名称不再像 2一样需要引入 config 模块,而是都改成像 dom 事件一样的字符串,具体见 events 文档,需要注意的是,legend,地图等的选中事件名称都从 legendselected, mapselected 改为了 legendselectedchanged, mapselectedchanged,如下示例:

myChart.on('legendselectchanged', function () {} );

然后是不再像 2 那样通过组件暴露接口去实现程序实现数据区域选择等功能,而统一改为 dispatchAction 的方式,例如:

myChart.dispatchAction({
  type: 'dataZoom',
  start: 10,
  end: 20
});

这种方式可以使得所有行为的管理更加统一,而且不用暴露内部的代码组织。

可以参见文档 action

最后是联动 connect 的改动,见 http://echarts.baidu.com/api.html#echarts.connect

3. 地图数据不再内置

3 中对于地图数据精度提升了很多,地图体积也大了很多,再内置就不合适了,所以 3 中把所以地图数据外置了,但是对地图引入方式进行了大大的简化。可以直接引入一个地图的 js 文件,也可以引入地图的 json 文件后通过 registerMap 方法注册地图。

4. 配置项结构的改动

我们在 3 中尽力做到跟 2 配置项兼容,特别是折,柱,饼,散点,仪表盘,漏斗图等基础图表,有些配置项层级的改动,比如 label,areaStyle 等原先在 itemStyle 层级下的都移到了 series 层级下跟 itemStyle 同级,例如:

{
  label: { normal: { show: true } }
  itemStyle: { normal: {} }
}

这些小改动有许多,这里不一一列举了,当然这些改动都会做到向后兼容,原先的写法也依然能用,只是不再推荐。

5. 地图和关系图的改动

地图不再使用 markPoint 和 markLine 去画点和线的数据了,markPoint 和 markLine 的定位就是辅助标记,在 3 中有特定的 lines 类型绘制特定的线数据,点数据也可以使用地理坐标系上的散点图实现,见示例 全国主要城市空气质量

还有关系图绘制也是改动很大的一个地方,2 中的 force 图在 3 中不复存在,取而代之的是更加通用的 graph,在 graph 中可以应用更多的布局方法,除了 2 中的 force-directed 布局,也可以是环形布局,也可以预先布局好后存放到 x,y 属性中直接展现,也可以自己扩展布局,比如这个 echarts-dagre 扩展

6. 去掉了拖拽重计算,树图,和弦图,字符云,韦恩图

树图,字符云和韦恩图这三个图我们觉得在 2 中很不成熟,3 中对其优化改进前先暂时不支持,拖拽重计算我们觉得使用的人并不多,又会增加不少代码体积,所以也先去掉了,不排除后面会通过扩展的方式加入。

然后关于 3 的新特性,可以见文章 echarts 3 带来了什么,实际上这篇文章发布以来后的各个新版本我们又陆续加入了很多新特性。感兴趣的话可以看示例 和各个版本的 changelog

@huang-x-h

This comment has been minimized.

Show comment
Hide comment
@huang-x-h

huang-x-h Jun 1, 2016

@pissang 多谢,这个可以整理到 Wiki 中方便查看

huang-x-h commented Jun 1, 2016

@pissang 多谢,这个可以整理到 Wiki 中方便查看

@huang-x-h

This comment has been minimized.

Show comment
Hide comment
@huang-x-h

huang-x-h Jun 1, 2016

还有几个问题,主要是关于 ZRender

  1. 现在用的 echarts2.2.5 版本,如何查看这个版本依赖 ZRender 的版本信息?
  2. ZRender2.*ZRender3.* 这两者之间有没有相应的接口变更信息(ZRender 官网没有看到)

huang-x-h commented Jun 1, 2016

还有几个问题,主要是关于 ZRender

  1. 现在用的 echarts2.2.5 版本,如何查看这个版本依赖 ZRender 的版本信息?
  2. ZRender2.*ZRender3.* 这两者之间有没有相应的接口变更信息(ZRender 官网没有看到)
@pissang

This comment has been minimized.

Show comment
Hide comment
@pissang

pissang Jun 1, 2016

Contributor

npm install 的时候会更新 zrender 到合适的版本,package.json 中也有依赖信息,zrender 3 暂时不开放给外部,只是作为一个 echarts 基础库

Contributor

pissang commented Jun 1, 2016

npm install 的时候会更新 zrender 到合适的版本,package.json 中也有依赖信息,zrender 3 暂时不开放给外部,只是作为一个 echarts 基础库

@huang-x-h

This comment has been minimized.

Show comment
Hide comment
@huang-x-h

huang-x-h Jun 1, 2016

我们有在 zrender3 上做了二次开发,如果要统一的话,是不是升级echarts到3的版本

huang-x-h commented Jun 1, 2016

我们有在 zrender3 上做了二次开发,如果要统一的话,是不是升级echarts到3的版本

@huang-x-h

This comment has been minimized.

Show comment
Hide comment
@huang-x-h

huang-x-h Jun 1, 2016

换句话说,基于 zrender3.0.5 做的二次开发,能否运行在 echars2.2.5 上?(echart2.2.5版本就包含了zrender)

huang-x-h commented Jun 1, 2016

换句话说,基于 zrender3.0.5 做的二次开发,能否运行在 echars2.2.5 上?(echart2.2.5版本就包含了zrender)

@pissang

This comment has been minimized.

Show comment
Hide comment
@pissang

pissang Jun 1, 2016

Contributor

不行的,需要升级 echarts

Contributor

pissang commented Jun 1, 2016

不行的,需要升级 echarts

@huang-x-h

This comment has been minimized.

Show comment
Hide comment
@huang-x-h

huang-x-h Jun 1, 2016

好的,多谢,坐等详细的 ehcarts2.* to echarts3.* 变更使用说明 👍

huang-x-h commented Jun 1, 2016

好的,多谢,坐等详细的 ehcarts2.* to echarts3.* 变更使用说明 👍

@yangpu

This comment has been minimized.

Show comment
Hide comment
@yangpu

yangpu Jun 12, 2016

3.0是否还支持2.0的SVG扩展地图?

yangpu commented Jun 12, 2016

3.0是否还支持2.0的SVG扩展地图?

@DeeplyPig

This comment has been minimized.

Show comment
Hide comment
@DeeplyPig

DeeplyPig Jan 18, 2017

echarts 3.0监听事件简化后,在IE8下捕获不到,比方说点击事件。echarts 2 通过echarts/config的EVENT.CLICK还能捕获到。这个有办法解决吗?

DeeplyPig commented Jan 18, 2017

echarts 3.0监听事件简化后,在IE8下捕获不到,比方说点击事件。echarts 2 通过echarts/config的EVENT.CLICK还能捕获到。这个有办法解决吗?

@yangpeijia

This comment has been minimized.

Show comment
Hide comment
@yangpeijia

yangpeijia Nov 6, 2017

想问问echarts 3 兼容IE 8吗?

yangpeijia commented Nov 6, 2017

想问问echarts 3 兼容IE 8吗?

@100pah

This comment has been minimized.

Show comment
Hide comment
@100pah

100pah Nov 8, 2017

Member

@yangpeijia 简单图表是兼容 ie8 的。

Member

100pah commented Nov 8, 2017

@yangpeijia 简单图表是兼容 ie8 的。

@fanslin

This comment has been minimized.

Show comment
Hide comment
@fanslin

fanslin Dec 6, 2017

echarts 2 的热力图在 echarts 3 中不支持了?

fanslin commented Dec 6, 2017

echarts 2 的热力图在 echarts 3 中不支持了?

@chenzulu123

This comment has been minimized.

Show comment
Hide comment
@chenzulu123

chenzulu123 Dec 20, 2017

Echarts3.5的主题河流怎么设置点击事件?使用API添加的事件不起作用,还是说主题河流不能添加事件?

chenzulu123 commented Dec 20, 2017

Echarts3.5的主题河流怎么设置点击事件?使用API添加的事件不起作用,还是说主题河流不能添加事件?

@zhongweidickens

This comment has been minimized.

Show comment
Hide comment
@zhongweidickens

zhongweidickens May 25, 2018

请教一下目前我使用的是echarts4.1.0版本,在使用世界地图的时候使用markPoint 一直抛coordSys.getOtherAxis is not a function 这个错误,请教一下各位怎么解决呢,在echarts2.2.7版本中是不会报错,同样的代码在4.1.0中有问题。请指教一下 @pissang

zhongweidickens commented May 25, 2018

请教一下目前我使用的是echarts4.1.0版本,在使用世界地图的时候使用markPoint 一直抛coordSys.getOtherAxis is not a function 这个错误,请教一下各位怎么解决呢,在echarts2.2.7版本中是不会报错,同样的代码在4.1.0中有问题。请指教一下 @pissang

@huwei0583

This comment has been minimized.

Show comment
Hide comment
@huwei0583

huwei0583 Jul 19, 2018

我想问个问题,我在官网下的兼容IE8版本,为啥好多图表在IE8显示不正常。实在找不到解决方案了

huwei0583 commented Jul 19, 2018

我想问个问题,我在官网下的兼容IE8版本,为啥好多图表在IE8显示不正常。实在找不到解决方案了

@huang-x-h

This comment has been minimized.

Show comment
Hide comment
@huang-x-h

huang-x-h Jul 25, 2018

@huwei0583 是显示不正常还是报错了,IE8是用VML来绘制的,感觉已经慢慢开始遗弃了

huang-x-h commented Jul 25, 2018

@huwei0583 是显示不正常还是报错了,IE8是用VML来绘制的,感觉已经慢慢开始遗弃了

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment