echarts-liquidfill:Apache ECharts的液体填充表（正在培养）

# Liquid Fill Chart Liquid Fill Chart plugin for [Apache ECharts](https://github.com/apache/incubator-echarts), which is usually used to represent data in percentage.  ## Install ECharts To use ECharts plugins, you need to include the plugin JavaScript file after ECharts file. ```html <script src='echarts.js'></script> <script src='echarts-liquidfill.js'></script> ``` ECharts can be downloaded at [GitHub dist directory](https://github.com/ecomfe/echarts/tree/master/dist) or [Download page of Official Website](http://echarts.baidu.com/download.html) (in Chinese). >#### NOTE > > The minimum package of ECharts required by LiquidFill Chart is [simple version](https://github.com/ecomfe/echarts/blob/master/dist/echarts.simple.js) on GitHub, or selecting nothing in [online builder](http://echarts.baidu.com/builder.html) (in Chinese). If you need other chart types or components in your other chart, you should include them accordingly. ## Install echarts-liquidfill with npm ```sh # install echarts as peer dependency npm install echarts npm install echarts-liquidfill ``` NOTE: echarts-liquidfill@3 is compitable with echarts@5 echarts-liquidfill@2 is compitable with echarts@4 ## Download echarts-liquidfill from GitHub You may download the lastest ECharts files on [ECharts official site](http://echarts.baidu.com/download.html) and download this plugin in [dist directory](https://github.com/ecomfe/echarts-liquidfill/tree/master/dist). **Note that if you need tooltip for Liquid Fill Chart, you need the complete ECharts version. Otherwise, the simple version will be competent.** ## Important Notes ### Omitted `normal` Since [ECharts v4.0.0]((https://github.com/ecomfe/echarts/releases/tag/4.0.0)), `normal` is no longer needed for `itemStyle` or `label`. ### Flatten `textStyle` Since [ECharts v3.7.0](https://github.com/ecomfe/echarts/releases/tag/3.7.0), `textStyle` option is flatten, so that `series.label[normal|emphasis].textStyle.xxx` is now can be written in `series.label[normal|emphasis].textStyle`. This is supported from [echarts-liquidfill](https://github.com/ecomfe/echarts-liquidfill/releases/tag/v1.0.6) v1.0.6. So if you found examples with `textStyle` in old demo, don't be too surprised. ## Quick Start - [API](https://github.com/ecomfe/echarts-liquidfill#api) - [Examples at ECharts Gallery](http://gallery.echartsjs.com/explore.html#tags=liquidFill~sort=rank~timeframe=all~author=all) Here are some common uses: - [Use multiple waves in a chart](https://github.com/ecomfe/echarts-liquidfill#multiple-waves) - [Change waves color and opacity](https://github.com/ecomfe/echarts-liquidfill#color-and-opacity) - [Make waves static](https://github.com/ecomfe/echarts-liquidfill#static-waves) - [Water with no waves](https://github.com/ecomfe/echarts-liquidfill#still-water) - [Set attributes for a single wave](https://github.com/ecomfe/echarts-liquidfill#change-a-single-wave) - [Change background and border style](https://github.com/ecomfe/echarts-liquidfill#background-style) - [Hide outline in chart](https://github.com/ecomfe/echarts-liquidfill#outline-style) - [Change shape with SVG](https://github.com/ecomfe/echarts-liquidfill#shape) - [Setup animation](https://github.com/ecomfe/echarts-liquidfill#animation) - [Change text content and style](https://github.com/ecomfe/echarts-liquidfill#change-text) - [Change shadow style](https://github.com/ecomfe/echarts-liquidfill#shadow) - [Setup tooltip](https://github.com/ecomfe/echarts-liquidfill#tooltip) - [Click event](https://github.com/ecomfe/echarts-liquidfill#click-event) - [Make an element non-interactable](https://github.com/ecomfe/echarts-liquidfill#non-interactable) To ask a question, you may fork [Liquid Fill Chart Example on Gallery](http://gallery.echartsjs.com/editor.html?c=xr1XplzB4e) and copy your code there. Then you may [open an issue](https://github.com/ecomfe/echarts-liquidfill/issues/new) in this project. ## Examples ### A Simple Example To create a Liquid Fill Chart, you need to have a series with type of `'liquidFill'`. A basic option may be: ```js var option = { series: [{ type: 'liquidFill', data: [0.6] }] }; ```  [Run](http://gallery.echartsjs.com/editor.html?c=xr1XplzB4e) ### Multiple Waves It is easy to create a liquid fill chart will multiple waves, either to represent multiple data, or to improve the visual effect of the chart. ```js var option = { series: [{ type: 'liquidFill', data: [0.6, 0.5, 0.4, 0.3] }] }; ``` This creates a chart wit waves at position of 60%, 50%, 40%, and 30%.  [Run](http://gallery.echartsjs.com/editor.html?c=xSyIEWMBNl) ### Color and Opacity To set colors for liquid fill chart series, set `color` to be an array of colors. To set opacity, use `itemStyle.opacity` and `itemStyle.emphasis.opacity` for normal style and hover style. ```js var option = { series: [{ type: 'liquidFill', data: [0.5, 0.4, 0.3], color: ['red', '#0f0', 'rgb(0, 0, 255)'], itemStyle: { opacity: 0.6 }, emphasis: { itemStyle: { opacity: 0.9 } } }] }; ```  [Run](http://gallery.echartsjs.com/editor.html?c=xrJpDC704l) You may also set the color and opacity of a single data item by: ```js var option = { series: [{ type: 'liquidFill', data: [0.5, 0.4, { value: 0.3, itemStyle: { color: 'red', opacity: 0.6 }, emphasis: { itemStyle: { opacity: 0.9 } } }] }] }; ```  [Run](http://gallery.echartsjs.com/editor.html?c=xBJPCRXR4l) ### Static Waves To provent the waves from moving left or right, you may simply set `waveAnimation` to be `false`. To disable the animation of waves raising, set `animationDuration` and `animationDurationUpdate` to be 0. ```js var option = { series: [{ type: 'liquidFill', waveAnimation: false, animationDuration: 0, animationDurationUpdate: 0, data: [0.6, 0.5, 0.4, 0.3] }] }; ```  [Run](http://gallery.echartsjs.com/editor.html?c=xH1VfVVREx) ### Still Water You may set the `amplitude` to be 0 to make still waves. ```js var option = { series: [{ type: 'liquidFill', data: [0.6, 0.5, 0.4, 0.3], amplitude: 0, waveAnimation: 0 }] }; ``` It is recommended to set `waveAnimation` to be false in this case to disable animation for performance consideration.  [Run](http://gallery.echartsjs.com/editor.html?c=xHy1NHVCNx) ### Change A Single Wave To change a single wave, overwrite the options in data item. ```js var option = { series: [{ type: 'liquidFill', data: [0.6, { value: 0.5, direction: 'left', itemStyle: { color: 'red' } }, 0.4, 0.3] }] }; ```  [Run](http://gallery.echartsjs.com/editor.html?c=xry6CHNCVl) ### Background Style You can use backgroundStyle option to set the stroke, fill style of background shape. ```js var option = { series: [{ type: 'liquidFill', data: [0.6, 0.5, 0.4, 0.3], backgroundStyle: { borderWidth: 5, borderColor: 'red', color: 'yellow' } }] }; ```  [Run](http://gallery.echartsjs.com/