Skip to content

Latest commit

 

History

History
85 lines (76 loc) · 3.26 KB

README.md

File metadata and controls

85 lines (76 loc) · 3.26 KB
Raw

react-native-web-echarts

介绍

要在 react-native 上使用 echarts 的图表库，目前方法主要是使用 react-native 的 webview 利用网页的形式加载 echarts 的图形。 本项目尽量使用少的代码实现本功能。

安装

使用 npm 安装

npm install react-native-web-echarts --save

使用 yarn 安装（推荐）

yarn add react-native-web-echarts

使用

示例
import React from 'react'
import { View, Text, Button } from 'react-native'
import Echarts from 'react-native-web-echarts'

export default class EcahrtsDemo extends React.Component {
  state = {
    data: [15, 10, 26, 5, 20, 30]
  }
  render () {
    const option = {
      title: {
        text: 'ECharts demo'
      },
      tooltip: {},
      legend: {
        data:['销量']
      },
      xAxis: {
        data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]
      },
      yAxis: {},
      series: [{
        name: '销量',
        type: 'bar',
        data: this.state.data
      }]
    }
    return <View style={{flex: 1}}>
      <View style={{flex: 1, alignItems: 'center'}}>
        <Text>{'echarts demo'}</Text>
        <Echarts
          option={option}
          height={300}
        />
        <Button
          title="reload"
          onPress={() => { this.setState({ data: [...Array(6)].map(_ => Math.ceil(Math.random() * (30))) })} }
        />
      </View>
    </View>
  }
}
参数
  • option echarts的参数，跟echarts使用一样，参考echarts文档
  • width （可选/默认为100%）组件宽度，可以是数字或百分比
  • height （可选/默认300）组件高度，可以是数字或百分比
  • style （可选）除了宽度和高度已经固定设置以外， style 属性可以为组件添加其他样式
  • 其他 webview 属性：（可选）
    • onLoadStart
    • onLoad
    • onError
    • onLoadEnd
    • renderLoading
    • renderError

说明

  • 项目原理是在页面中建立一个固定大小的 webview 用来以网页的形式加载 echarts 的组件，所有的图表都是加载的一个html里面的 echarts 组件，根据设置 option 内容的不同表现出不同的图形。
  • 由于是web加载方式，所有图形显示会有一定的延迟
  • 由于在 Android 环境下，开发模式和生产模式读取文件资源形式不同，所以在生产模式下需要复制项目目录下的 echarts.min.js 和 tpl.html 等文件到 android/app/src/main/assets 目录下，打包后才能正常显示。
  • 开发者可以使用任意版本的 echarts 库，只需要将目录下 echarts.min.js 文件替换为需要的版本即可（注意安卓需要同时替换 assets 目录下的文件）
  • 开发者可以使用 echarts 的其他扩展库，需要修改 tpl.html 文件，在 <heard> 中引入 echarts 文件的后面 添加对应库的引用，如 <script src="echarts-liquidfill.js"></script>，同时需要将对应的库文件复制到本项目目录下（安卓版同时需要在原生assets目录下）