Easier Charting in React Native Using Apache ECharts — the Solution You Have Been Looking for

We have developed an open-source graphics library for react native APP, which is based on Apache ECharts and uses RNSVG or RNSkia for rendering in a way that is almost identical to using it on the web — making it suitable for almost any situation that requires visuals. The project source code is available at , and our official site is . https://github.com/wuba/react-native-echarts https://wuba.github.io/react-native-echarts/ Introduction When drawing charts, the chart library we use most frequently is ECharts. As one of the most mature chart libraries on the market, mainly for web-side use, there is no best way to use it in React Native. In the face of this situation, our solutions are: Option 1: To use chart libraries developed specifically for React Native as an alternative, such as react-native-charts-wrapper, victory-native, etc. The style and interaction of these chart libraries are different from ECahrts, and the richness of charts is not enough. Especially in the scenario of multi-platform requirements, a separate UI interaction design is needed for React Native. Option 2: Render charts in react-native-webview. This solution uses injectedJavaScript for initialization and postMessage for event response. You can directly use open-source libraries such as react-native-echarts-pro, native-echarts, etc. When there are multiple charts or too many chart elements on the page, it will encounter performance bottlenecks, such as the white screen phenomenon for large data volume area charts and single-axis scatter charts on Android. There will be obvious lag and frame drops during rendering. Therefore, we developed a new chart library that can integrate the capabilities of ECharts into React Native applications for better usability and stronger performance. Since we don’t want to write a graphics library from scratch, let’s look at what graphics libraries we currently have designed for React Native: react-native-svg: provides SVG support to React Native on iOS, Android, macOS, Windows, and a compatibility layer for the web. react-native-skia: React Native Skia brings the Skia Graphics Library to React Native. Skia serves as the graphics engine for Google Chrome and Chrome OS, Android, Flutter, Mozilla Firefox and Firefox OS, and many other products. It also provides an ImageSVG component that supports rendering of SVG formatted images. We know that ECharts supports SVG rendering, so if we get the SVG data before the chart is rendered and provide it to react-native-svg or react-native-skia for rendering, we will be able to achieve our goal. After a period of experimentation, we have developed with the following features： wrn-echart 🔥 The same way as Apache ECharts 🎨 Rich charts, covering almost all usage scenarios ✨ Optional rendering library, Skia or SVG 🚀 Able to reuse code with web 📱 Support for zoom gestures How to use In practice, the overall process for wrn-echarts is similar to ECharts: yarn add wrn-echarts Choose to install react-native-svg or @shopify/react-native-skia Introduce the relevant components from wrn-echarts Replace the SVGRenderer of ECharts with the SVGRenderer of wrn-echarts Write the option configuration information for the chart Use SkiaChart / SvgChart component Here is the sample code： // import { SkiaChart, SVGRenderer } from 'wrn-echarts'; import SkiaChart, { SVGRenderer } from 'wrn-echarts/skiaChart'; import * as echarts from 'echarts/core'; import { useRef, useEffect } from 'react'; import { LineChart } from 'echarts/charts'; echarts.use([ SVGRenderer, LineChart ]) export default function App() { const skiaRef = useRef (null); useEffect(() => { const option = { xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] }, yAxis: { type: 'value' }, series: [ { data: [150, 230, 224, 218, 135, 147, 260], type: 'line' } ] } let chart: any; if (skiaRef.current) { chart = echarts.init(skiaRef.current, 'light', { renderer: 'svg', width: 250, height: 300, }); chart.setOption(option); } return () => chart?.dispose(); }, []); return ; } Here is a screenshot of it: Isn’t it particularly easy? More chart configurations can be viewed on the echarts website. We support most of the charts currently supported by ECharts. I will show some of the charts below, and more examples can be seen on the taro-playground project. Performance As mentioned before, the mainstream solution for using ECharts in React Native is to implement it via WebView. Among the many WebView-based implementations, react-native-echarts-pro has more users, so we chose react-native-echarts-pro as a comparison. The following are screenshots of the initialization process for the different implementations: After quite a few test cases, we found that wrn-echarts has performance advantages in regular usage scenarios. Still, in scenarios with large amounts of data, there will be significant lag because of the declarative UI rendering method, which we will continue to improve. Implementation details Above is the flowchart of the library, taking react-native-svg as an example, the core workflow is: Replace the SVGRenderer of ECharts, and replace the registered SVGPainter with the custom SVGPainter. CustomSVGPainter inherits from SVGPainter, overwrites the constructor and part of the refresh function, calls the patch function registered on SVGComponent when the chart data is initialized or updated, and passes the calculated new SVG data to it. Define SVGComponent, which manages the current chart instance and has a core patch function on it to receive real-time SVG data and then call the SVGElement function. SVGElement function iterates all SVG nodes and transforms them into the corresponding SVG elements provided by react-native-svg for the final rendering action. When using react-native-skia, there are some differences. There is a core method patchString on the defined SkiaComponent component. patchString receives the changed SVG data, converts it into SVG string, and passes it to the ImageSVG component of react-native-skia for rendering. Handling TouchEvent ECharts events are mouse events, such as click, dblclick, mousedown, mousemove, etc. The mouse events are used to trigger the display or animation of the chart elements. We use the PanResponder of React Native to capture the events. Then, we simulate the mobile TouchEvent as a mouse event and dispatch it to the chart instance generated by the ECharts init method. For example, the action of following the mouse to display the legend on the chart is TouchStart + TouchMove on the mobile side, which translates to a mouse event of mousedown + mousemove. Another example is the zooming of the chart. The mobile side is two-finger zooming, which is translated to the mouse mousewheel event, and the corresponding mousewheel scrolling distance is calculated by the two-finger distance change. Here is the key code: Convert TouchEvent to MouseEvent PanResponder.create({ onPanResponderGrant: ({ nativeEvent }) => { // Action start, translated into mouse down and move events dispatchEvent( zrenderId, ['mousedown', 'mousemove'], nativeEvent, 'start' ); }, onPanResponderMove: ({ nativeEvent }) => { // Handling finger movement operations const length = nativeEvent.touches.length; if (length === 1) { // single finger } else if (length === 2) { // Handling two-finger movement operations here if (!zooming) { // ... } else { // Here the event is converted to a scroll wheel const { initialX, initialY, prevDistance } = pan.current; const delta = distance - prevDistance; pan.current.prevDistance = distance; dispatchEvent(zrenderId, ['mousewheel'], nativeEvent, undefined, { zrX: initialX, zrY: initialY, zrDelta: delta / 120, }); } } }, onPanResponderRelease: ({ nativeEvent }) => { // The action is over, where it is transformed into a mouse click release operation }, }) Applying a MouseEvent to an ECharts chart instance function dispatchEvent( zrenderId: number, types: HandlerName[], nativeEvent: NativeTouchEvent, stage: 'start' | 'end' | 'change' | undefined, props: any = { zrX: nativeEvent.locationX, zrY: nativeEvent.locationY, } ) { if (zrenderId) { var handler = getInstance(zrenderId).handler; types.forEach(function (type) { handler.dispatch(type, { preventDefault: noop, stopImmediatePropagation: noop, stopPropagation: noop, ...props, }); stage && handler.processGesture(wrapTouch(nativeEvent), stage); }); } } For more information Go to to view the source code, and give us a star if you like it. If you encounter any problems, you can submit an issue. https://github.com/wuba/react-native-echarts The sample code in this post is on the project, which is also open source. Interested parties can also install the new version of the Taro Playground app directly from the app store or from the releases page to experience it. https://github.com/wuba/taro-playground Also published . here