react-native-secharts
一个webview封装的图表组件。基于百度echarts4,相比native-echarts有echarts自带对象支持,例如渐变色等,用法与官网相同用法。
echarts version 4.1.0
注:react-native 0.56 版本以上,webview改版, https://reactnative.cn/docs/webview/ 本组件分为0.56以上(包含), 0.56以下, 请阅读以下安装步骤。
安装步骤
安装依赖
react-native >= 0.56
yarn add react-native-secharts
或者
npm install react-native-secharts --save
react-native < 0.56
yarn add react-native-secharts@1.4.5
或者
npm install react-native-secharts@1.4.5 --save
修复android release bug
在你的项目创建此路径的文件夹 $yourProject/android/app/src/main/assets/echarts,
创建完成后请在你的项目根目录(`$yourProject/) 文件夹下使用命令
以下是 mac && linux
cp node_modules/react-native-secharts/main/dist/index.html android/app/src/main/assets/echarts/ && cp node_modules/react-native-secharts/main/dist/Bmap.html android/app/src/main/assets/echarts/
以下是 windows
copy node_modules/react-native-secharts/main/dist/index.html android/app/src/main/assets/echarts/ && copy node_modules/react-native-secharts/main/dist/Bmap.html android/app/src/main/assets/echarts/
引用组件
import {Echarts, echarts} from 'react-native-secharts';
大写开头的Echarts是组件
小写开头的echarts是echarts对象
使用组件
请看example文件夹中示例代码
运行示例
$ cd example
$ yarn
$ react-native run-ios 或者 $ react-native run-android
props
属性
类型
默认值
备注
option
obj
null
echarts配置项,请参考echarts官网
backgroundColor
string
'rgba(0,0,0,0)'
图表画布背景色
width
number
'auto'
画布宽度
height
number
400
画布高度
renderLoading
func
()=>
loading时遮罩
onPress
func
(e)=>{}
点击事件
isMap
boolen
false
是否为地图
实例方法
方法名称
参数
备注
setOption
(option: Object, notMerge?: boolean, lazyUpdate?: boolean)
getImage
(base64)=>{}
返回函数的参数base64,可结合RNFS写入相册
clear
无
清空echarts画布
历史版本特性
1.5.0 更新组件到支持rn0.56版本,修复ios release出现的不能渲染的bug。
1.4.5 更新echarts版本到4.1.0
1.4.4 增加echart实例方法setOption的附加参数调用,增加clear实例方法调用
1.4.3 修复设置了echarts地图,其余图表只能显示一个的问题
1.4.2 修复echarts地图不能显示的问题,目前只支持echarts最新的bmap形式。
1.4.0 更新echarts版本到4.1.0.rc2,修复图表点击事件。
1.3.9 修复formatter属性function被屏蔽的问题。
1.3.7 修复了flex:1不能显示的问题
1.3.6 修复了formatter属性不能使用clang系的转译字符,以及被误转为string的问题
1.3.3 新增获取图片getImage方法 ,使用refs获取组件实例进行使用
1.3.0 新增echarts对象,可以使用对象内对应方法,例如渐变等
1.2.0 主分支更新至echarts4
1.1.0 新增刷新option方法 ,使用refs获取组件实例进行使用
1.0.0 上传基础组件,基于echarts3封装,修复了ios android闪白,ios默认移动适配,以及android release路径问题
以下是示例图
例子和地图
柱状图
折线图
饼状图