深入了解响应式React Native Echarts组件


Posted in Javascript onMay 29, 2019

前言

一种在 React Native 中封装的响应式 Echarts 组件,使用与示例请参见:react-native-echarts-demo

近年来,随着移动端对数据可视化的要求越来越高,类似 MPAndroidChart 这样的传统图表库已经不能满足产品经理日益变态的需求。前端领域数据可视化的发展相对繁荣一些,通过 WebView 在移动端使用 Echarts 这样功能强大的前端数据可视化库,是解决问题的好办法。

React Native 开发中,由于使用的是与前端相同的 JavaScript 语言,衔接 Echarts 的工作相对顺畅些,不过一些必要的组件封装还是能够大大提高开发效率的。

Echarts 官方推荐过一个第三方封装库:react-native-echarts(注:它对应的 nmp package 名字为native-echarts ),目前有 400+ stars 和 100+ 的周下载量,可见还是被广泛使用的。但是我们经过调研,发现 react-native-echarts 存在以下一些问题:

  • 该库已半年多未更新,Echarts 版本停留在 3.0 ,Android 端打包需手动添加 assets 的问题也一直未处理
  • 库的接口灵活度较低,比如只能通过 width、height 设置大小;无法使用 Echarts 扩展包;无法进行事件注册、WebView 通信等

由于用WebView 封装 Echarts 涉及到本地 html,不是纯 JavaScript 语言层面的功能,又没有 native 代码,所以做成 nmp package 并不是一个很好的选择,写成项目里的内部组件,自己进行配置反而是更方便更灵活的方案。

因此我们决定不使用第三方的 Echarts 封装库,自己写一个通用组件 WebChart 。为方便开发中使用,该组件具有以下特点:

  • 按照响应式进行设计,只需在 option 中配置好数据源,数据变化后图表就会自动刷新,更符合 React 的风格。
  • 我们的方案是在组件每次 update 时判断传入的 option 参数是否发生变化,如果变化通过 webView.postMessage ,以 JSON 的形式传入新的 option ,通知 Echarts 重新 setOption 。
  • 虽然 Echarts 本身会对 option 进行对比,但事先判断可以减少 update 导致的与 WebView 频繁通信,这一点在容器父组件中有大量异步请求时还是很明显的;在 WebView 内部,更新则是采用 Echarts 本身的 setOption 而无需 reload 整个 WebView
  • 利用 WebView 的 postMessage 和 onMessage 接口,可实现图表与其它 React Native 组件的事件通信
  • 通过组件的 exScript 参数,可为 WebView 添加任意脚本,使用灵活
  • 由于是自己写的组件, echarts 版本、扩展包,svg/canvas 、数据增量加载都可以自己设定

Demo 与使用方法

使用与示例请参见:react-native-echarts-demo,如果你需要直接使用,可按以下步骤移植:

将根目录下的 WebChart 组件文件夹拷到你项目中合适的地方
将 /android/app/src/main/assets/web 文件夹拷到你项目同样位置,没有 assets 文件夹需手动创建。
只需以上两步就可以在项目中使用 WebChart 组件了。

如果需要进一步定制的话,Echarts 代码在以上两个文件夹中的 index.html 里 <script /> 标签内,目前是放的是 4.0 完整版,无扩展包,可到官网下载所需的版本和扩展包替换;svg/canvas 、数据增量加载等可在 WebChart/index.js 中直接进行修改。在移动端,出于性能的考虑,我们一般使用 svg 的渲染模式。

WebChart 具体使用可参见 App.js ,style 的设置就和普通的 React Native 组件一样,可使用 flex ,也可设为定值。额外的三个参数:

  • option(object):赋给 setOption 的参数对象,发生变化后 WebChart 内部会自动调用 setOption ,实现响应式刷新。特别注意,JSON 解析时未进行函数的处理,所以需避免使用函数式的 formatter 和类形式的 LinearGradient ,和 demo 一样使用模板式和普通对象的吧
  • exScript(string):任何你想在 WebView 加载时执行的代码,一般会是事件注册之类的,推荐使用模板字面量
  • onMessage(function):WebView 内部触发 postMessage 之后的回调,postMessage 需先在 exScript 中进行设置,用于图表与其它 React Native 组件的通信

当然这是根据我们的业务需要设计的参数,你完全可以自由重新设定。

Echarts与React Native组件的通信

在 React Native 的 WebView 组件中,提供了 onMessage 和 postMessage 来进行 html 与组件的双向通信,具体使用可参加文档。

利用 webView.postMessage ,WebChart 实现了通知 Echarts 执行 setOption ;在 exScript 中,可利用 window.postMessage 实现 Echarts 的事件向 React Native 组件的通信。

一般我们会约定通信的 data 为这样格式的对象:

{
type: 'someType',
payload: {
value: 111,
},
}

由于 onMessage 和 postMessage 只能进行字符串的传递,在 exScript 需进行 JSON 序列化,类似这样:

exScript={`
chart.on('click', (params) => {
if(params.componentType === 'series') {
window.postMessage(JSON.stringify({
type: 'select',
payload: {
index: params.dataIndex,
},
}));
}
});
`}

以上就是我们封装的响应式 WebChart 组件及使用,完整代码请参见:react-native-echarts-demo。

在使用中,还有以下几个坑未解决,目前只能绕过,欢迎知道的同学指正:

  • 在 IOS 中,Echarts 好像渲染不出透明的效果,用 rgba 设置的颜色不能正常
  • React Native 的 WebView 好像 style.height 属性无效,因此不得不在外面套了个 View
  • 按现在的资源加载方式,index.html 在 Android 上会有两份。因为平台判断是运行时进行的,哪怕分开设置 index.anroid.js 和 index.ios.js 打包时也会都打包进去,而 Android 中又必须手动添加 assets
  • index.html 中必须内联引入 Echarts 的代码,外部引用单独的 js 文件好像无效

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
jQuery EasyUI API 中文文档 - Menu菜单
Oct 03 Javascript
JS Jquery 遍历,筛选页面元素 自动完成(实现代码)
Jul 08 Javascript
用RadioButten或CheckBox实现div的显示与隐藏
Sep 21 Javascript
javascript实现无缝上下滚动特效
Dec 16 Javascript
关于angularJs指令的Scope(作用域)介绍
Oct 25 Javascript
利用python分析access日志的方法
Oct 26 Javascript
JavaScript 事件流、事件处理程序及事件对象总结
Apr 01 Javascript
利用node.js写一个爬取知乎妹纸图的小爬虫
May 03 Javascript
Vue引用第三方datepicker插件无法监听datepicker输入框的值的解决
Jan 27 Javascript
jQuery实现浏览器之间跳转并传递参数功能【支持中文字符】
Mar 28 jQuery
Vuejs监听vuex中值的变化的方法示例
Dec 02 Javascript
JS XMLHttpRequest原理与使用方法深入详解
Apr 30 Javascript
node将geojson转shp返回给前端的实现方法
May 29 #Javascript
node学习笔记之读写文件与开启第一个web服务器操作示例
May 29 #Javascript
关于element-ui的隐藏组件el-scrollbar的使用
May 29 #Javascript
JS学习笔记之数组去重实现方法小结
May 29 #Javascript
基于Vue实现电商SKU组合算法问题
May 29 #Javascript
JS学习笔记之闭包小案例分析
May 29 #Javascript
JS学习笔记之贪吃蛇小游戏demo实例详解
May 29 #Javascript
You might like
php设计模式 Adapter(适配器模式)
2011/06/26 PHP
PHP实现把数字ID转字母ID
2013/08/12 PHP
ThinkPHP CURD方法之page方法详解
2014/06/18 PHP
PHP中的类型提示(type hinting)功能介绍
2015/07/01 PHP
php metaphone()函数的定义和用法
2016/05/15 PHP
PHP使用星号替代用户名手机和邮箱的实现代码
2018/02/07 PHP
论坛特效代码收集(落伍转发-不错)
2006/12/02 Javascript
jquery将一个表单序列化为一个对象的方法
2014/01/03 Javascript
使用js实现关闭js弹出层的窗口
2014/02/10 Javascript
JavaScript与jQuery实现的闪烁输入效果
2016/02/18 Javascript
JS前端开发判断是否是手机端并跳转操作(小结)
2017/02/05 Javascript
vue.js框架实现表单排序和分页效果
2017/08/09 Javascript
Js利用prototype自定义数组方法示例
2017/10/20 Javascript
详解angular2.x创建项目入门指令
2018/10/11 Javascript
JS typeof fn === 'function' &amp;&amp; fn()详解
2020/08/22 Javascript
python实现系统状态监测和故障转移实例方法
2013/11/18 Python
Python读取和处理文件后缀为.sqlite的数据文件(实例讲解)
2017/06/27 Python
Python基础知识点 初识Python.md
2019/05/14 Python
使用pycharm在本地开发并实时同步到服务器
2019/08/02 Python
python实现一个函数版的名片管理系统过程解析
2019/08/27 Python
DjangoWeb使用Datatable进行后端分页的实现
2020/05/18 Python
selenium自动化测试入门实战
2020/12/21 Python
数以千计的折扣工业产品:ESE Direct
2018/05/20 全球购物
德国消费电子产品购物网站:Guter Kauf
2020/09/15 全球购物
实现向右循环移位
2014/07/31 面试题
毕业生造价工程师求职信
2013/10/17 职场文书
大学生专科毕业生自我评价
2013/11/17 职场文书
经贸日语专业个人求职信范文
2014/04/29 职场文书
护士节策划方案
2014/05/19 职场文书
司法局火灾防控方案
2014/06/05 职场文书
赔偿协议书
2015/01/27 职场文书
小学运动会开幕词
2015/01/28 职场文书
工作收入证明模板
2015/06/12 职场文书
SqlServer 垂直分表(减少程序改动)
2021/04/16 SQL Server
将MySQL的表数据全量导入clichhouse库中
2022/03/21 MySQL
Python自动化实战之接口请求的实现
2022/05/30 Python