Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dawiwt/react-component-echarts
React component echarts. 组件式百度图表。
https://github.com/dawiwt/react-component-echarts
chart component echarts javascript jsx react react-component react-component-echarts
Last synced: 2 months ago
JSON representation
React component echarts. 组件式百度图表。
- Host: GitHub
- URL: https://github.com/dawiwt/react-component-echarts
- Owner: dawiwt
- License: mit
- Created: 2019-01-18T10:09:04.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-28T08:33:49.000Z (over 1 year ago)
- Last Synced: 2024-07-07T02:26:55.285Z (3 months ago)
- Topics: chart, component, echarts, javascript, jsx, react, react-component, react-component-echarts
- Language: JavaScript
- Homepage: https://dawiwt.com/react-component-echarts
- Size: 4.75 MB
- Stars: 172
- Watchers: 6
- Forks: 13
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-react-cn - React component echarts. 组件式百度图表
README
# React Component Echarts
组件式百度图表，示例 https://dawiwt.com/react-component-echarts
[](https://travis-ci.org/dawiwt/react-component-echarts) [](https://www.npmjs.com/package/react-component-echarts) [](https://www.npmjs.com/package/react-component-echarts)
## Feature
- 组件式开发
- 图表自适应
- 功能完全兼容`echarts`本身功能
- 通过`Props`配置，学习、维护成本更低
- 支持[辅助工具](https://dawiwt.com/react-component-echarts/tools.html)从配置到组件的快速转换，高效开发
## Install
```sh
#安装包
npm install react-component-echarts --save
#自主安装echarts
npm install echarts --save
```
## Quick Start
1. 复制你的 option
2. 点击[辅助工具](https://dawiwt.com/react-component-echarts/tools.html)
3. 粘贴 option 到文本框
4. 复制依赖组件与图表代码到你的业务逻辑中
5. 导入图表依赖 echarts 模块
6. 完成
## Usage
由于全部的图表和组件 ECharts 包体积会比较大，所以`react-component-echarts`只引入`ECharts`主模块，对于依赖的图表和组件，需要自己手动引入，这样可以有效减小打包后的体积，下面是一个简单示例，更多示例看[这里](https://dawiwt.com/react-component-echarts)；
```js
//导入组件
import { Recharts, Components } from 'react-component-echarts'
//导入 line 图表
import 'echarts/lib/component/line'
const { XAxis, YAxis, Series } = Components
//图表代码
```
可以按需引入的模块列表见[这里](https://github.com/ecomfe/echarts/blob/master/index.js)。
当然，如果不关心打包体积，为方便开发，可直接在入口文件通过`import 'echarts'`或`require('echarts')`引入全部图表组件。
## Components
- Recharts 图表根组件
- others 图表子组件，详见[列表](https://github.com/dawiwt/react-component-echarts/blob/master/tags.js)
除`Recharts`外，其它组件均为`options`中的对象存在; 例如，`options.title`作为图表标题的配置项，其值为对象，可以详细配置文本内容、位置、颜色、背景等复杂的样式结构，所以`title`会以组件的形式存在，即``; 而`options.animation`控制图表动画，其值为`boolean`等单一类型，所以`animation`以`Prop`的形式存在，即``; 另外，`options`配置项中对象的层级关系即对应着组件间的父子关系;
```js
//例如
//相当于
option = { xAxis: { type: 'category' } }
```
节点间的父子关系相当于对象间层级关系；
```js
//例如
//相当于
option = {
tooltip: {
trigger: 'axis',
axisPointer: {
type: 'cross',
label: {
backgroundColor: '#6a7985'
}
}
}
}
```
## Props
以下属性为`Recharts`节点仅有的几个`echarts`之外的属性，其它配置均为透传，无学习成本；
- `className` (optional, string) 图表容器 `class` 名
- `style` (optional, object) 图表容器样式
- `onEvents` (optional, array) 绑定图表事件
- `onLoad` (optional, function(Instance)) 图表首次加载完毕会执行 `onLoad`，`Instance` 为图表实例，可供调用百度图表 `API`
```js
console.log('click', params)], ['legendselectchanged', params => console.log('legendselectchanged', params)]]}>
...
```
除此以外，图表`init`事件与`setOption`事件的参数可以通过`Recharts`透传，均非必传，不传为`echarts`默认值；
```js
// init
...
// setOption
...
```
**特别说明：** 除`width`与`height`属性，其余的`init`与`setOption`属性会导致图表重绘。
更多属性查看 https://www.echartsjs.com/option.html
## Correlations
[戏说组件式百度图表的由来及简单逻辑](https://juejin.im/post/5ca59d00e51d4514f965c88e)
喜欢请给个 Star ，谢谢！
## LICENSE
MIT@[dawiwt](https://github.com/dawiwt)