search

apache / echarts

Apache ECharts is a powerful, interactive charting and data visualization library for browser
https://echarts.apache.org
Apache License 2.0
60.69k stars 19.62k forks source link

[Feature] Document difference between echarts and echarts.simple #20456

Open lonix1 opened 3 weeks ago

lonix1 commented 3 weeks ago

What problem does this feature solve?

New user here. I use chartjs which is about 250KiB, whereas echarts (dist/echarts.min.js) is about 1MiB. Massive difference!

So I was surprised to find another file dist/echarts.simple.min.js which is 450KiB. Still large, but a significantly better option. (There is also a "common" file.)

However, it is not documented anywhere. I have no way to know what it is or how it differs from the main js file.

What does the proposed API look like?

Please add the difference between these two files to the installation page, so users can make an informed decision about which to use.

Thanks!

helgasoft commented 3 weeks ago

I have no way to know what it is or how it differs from the main js file.

The obvious way is to compare the sources. I did and found that simple supports line, bar and pie charts only (not even scatter). Agree with you about the need for better documentation.

lonix1 commented 3 weeks ago

I'm a new user, so have no way of understanding the differences by comparing the sources. I hope someone with experience can document the differences.

Another difference:
I tried both, and discovered that the "simple" package doesn't include the feature where hovering over a pie chart shows a "tooltip" with extra data (which is very useful, so I'm using the regular package even though it's larger).

lonix1 commented 3 weeks ago

BTW: if the "simple" package is only line+bar+pie then it would have been nice to include all functionality for those graphs (including the tooltip feature mentioned above). And agree with you that scatter is a fundamental so would have been nice to have in "simple" package too.

MatthiasMert commented 3 weeks ago

If you are using a package manager you can build a minimal bundle by only including components you need: https://echarts.apache.org/en/tutorial.html#Use%20ECharts%20with%20bundler%20and%20NPM

lonix1 commented 3 weeks ago

Thanks! I saw that page, it seems very useful.

(Problem is I don't use js/node/npm, but rather the CDN option.)