react-native-fusionchart
v5.3.7
Published
React Native component for FusionCharts Javascript Charting Library
Downloads
29
Readme
FusionCharts React Native :
A React Native
component which provides bindings for FusionCharts
JavaScript Charting Library. It easily adds rich and interactive charts to any React Native
Projects.
Demo
- Github Repo: https://github.com/fusioncharts/react-native-fusioncharts
- Documentation: https://www.fusioncharts.com/dev/getting-started/react-native/your-first-chart-using-react-native
- Support: https://www.fusioncharts.com/contact-support
- FusionCharts
- Official Website: https://www.fusioncharts.com/
- Official NPM Package: https://www.npmjs.com/package/fusioncharts
- Issues: https://github.com/fusioncharts/react-native-fusioncharts/issues
Table of Contents
- Important Note
- Getting Started
- How to create your own application using FusionCharts – with Expo
- How to create your own application using FusionCharts – with React-Native CLI
- You can also use React-Native CLI to run an application created with Expo. This is how you do it:
- Quick Start
- Working with Events
- Working with APIs
- Working with modules
- License Configuration
- Usage and integration of FusionTime
- Going Beyond Charts
- For Contributors
- Licensing
Important Note
If you're using this package with Expo Tools, please make sure your Expo SDK version is higher than or equal to v50.0.0
.
In bare React Native application you need to also install the expo-modules package, and configure the content of ios and android build directiories like it's described here. Make sure to use React Native latest version.
- Run the following command in your project
$ npm install react-native-webview
- After that install react-native-fusioncharts in your app
$ npm install react-native-fusioncharts
- For iOS, go to your
ios
directory and run the following
$ npx pod-install
- For iOS, if you want to add export functionality for your charts, go to your
info.plist
file and add the following code
<key>NSPhotoLibraryUsageDescription</key>
<string>Photo Library Access for downloading the chart</string>
Getting Started
Requirements
- Node.js, NPM/Yarn installed globally in your OS.
Installation
This wrapper can be installed within app based on Expo tools, or bare React Native app.
How to create your own application using FusionCharts – with Expo
Make sure you have Node.js and Git installed in your environment. Check the official Expo’s documentation for more details.
Run the following command in Command Prompt to create a new application:
npx create-expo-app My-test-app.
Move to the previously created app folder: cd My-test-app
Install needed libraries for the FusionCharts:
npm i react-native-fusioncharts
- Now create the "metro.config.js" in the root folder by running this command:
npx expo customize metro.config.js
- Add the following code in metro.config.js file:
const { getDefaultConfig } = require('expo/metro-config');
const config = getDefaultConfig(__dirname);
config.resolver.assetExts.push(
// Adds support for `.fcscript` files for Fusionchart
'fcscript'
);
module.exports = config;
Replace the code in the "App.js" file to receive a desired chart. Example
Run the following command:
expo start
Expo should create a QR-code in your Command Prompt window.Open the Expo Go application on your device – you should have installed it in order to run your FusionCharts app on this device.
Make sure your device is on the same Wi-Fi network as the computer where you are executing Expo commands.
Scan the QR-code with the Expo Go scanner. The application will run on this device. It should display the charts properly.
You can make changes to your code while running the application on your device: it should automatically reload after you save the changes.
How to create your own application using FusionCharts – with React-Native CLI
Make sure you have the latest versions of Node and JDK installed in your environment. Dependencies for Android and iOS emulators. should also be setup properly. Check the official React Native documentation for more details.
Run the following command in Command Prompt to install the React Native CLI:
npm install -g react-native-cli
Run the following command in Command Prompt to create a new application:
react-native init My-test-app
.Run the command
cd My-test-app
to access your app.A new application named ‘My-test-app’ has been created. Update its code to include charts that you need to get displayed. Check our instructions for details.
In order to run your application on a connected Android device or an emulator, execute the following command: npx react-native run-android. It would take a few minutes to run the application.
To run it on an iOS device or simulator, execute the following command:
npx react-native run-iOS
.
You can also use React-Native CLI to run an application created with Expo. This is how you do it:
Follow steps 1-4 of the Expo guide above.
You have finished updating the code and accessed your application’s folder. Now run the following command:
expo eject
Expo will create /Android and /IOs folders in your application allowing you to run it with React-Native CLI
Make sure you have configured your environment dependencies for Android and iOS emulators. Check the official React Native documentation for more details.
Now you can use the command npx react-native run-android to run your application on Android or the command npx react-native run-iOS to run it on iOS.
After installing react-native-fusioncharts
, follow the steps below:
It is required to add the .fcscript into the asset extensions section of metro.config.js file, or create that file within your project, and configure it like below:
const { getDefaultConfig } = require('expo/metro-config');
const { mergeConfig } = require('@react-native/metro-config');
module.exports = function (baseConfig) {
const defaultConfig = mergeConfig(baseConfig, getDefaultConfig(__dirname));
const { resolver: { assetExts, sourceExts } } = defaultConfig;
return mergeConfig(
defaultConfig,
{
resolver: {
sourceExts,
assetExts: [...assetExts, 'fcscript']
},
},
);
};
Quick Start
Include the react-native-fusioncharts
library as follows:
The App.js
file:
import React from 'react';
import { Text, View } from 'react-native';
import ReactNativeFusionCharts from 'react-native-fusioncharts';
const Chart = () => {
const chartData = [
{ label: "Venezuela", value: "250" },
{ label: "Saudi", value: "260" },
{ label: "Canada", value: "180" },
{ label: "Iran", value: "140" },
{ label: "Russia", value: "115" },
{ label: "UAE", value: "100" },
{ label: "US", value: "30" },
{ label: "China", value: "30" },
];
const chartConfig = {
type: "column2D",
width: "300",
height: "400",
dataFormat: "json",
dataSource: {
chart: {
caption: "Countries With Most Oil Reserves [2017-18]",
subCaption: "In MMbbl = One Million barrels",
xAxisName: "Country",
yAxisName: "Reserves (MMbbl)",
numberSuffix: "K",
theme: "fusion",
exportEnabled: 1 // to enable the export chart functionality
},
data: chartData
}
};
return (
<View
style={{
flex: 1,
justifyContent: 'center',
alignItems: 'center',
marginTop: 50
}}>
<Text>Fusioncharts</Text>
<ReactNativeFusionCharts
chartConfig={chartConfig}
/>
</View>
);
};
export default Chart;
Working with Events
In this sample we are attaching dataplotclick event in the chart.
import { StatusBar } from 'expo-status-bar';
import { StyleSheet, Text, View, Alert } from 'react-native';
import ReactNativeFusionCharts from 'react-native-fusioncharts';
export default function App() {
const chartData = [
{ label: "Venezuela", value: "250" },
{ label: "Saudi", value: "260" },
{ label: "Canada", value: "180" },
{ label: "Iran", value: "140" },
{ label: "Russia", value: "115" },
{ label: "UAE", value: "100" },
{ label: "US", value: "30" },
{ label: "China", value: "30" },
];
const chartConfig = {
type: "column2D",
width: "300",
height: "400",
dataFormat: "json",
dataSource: {
chart: {
caption: "Countries With Most Oil Reserves [2017-18]",
subCaption: "In MMbbl = One Million barrels",
xAxisName: "Country",
yAxisName: "Reserves (MMbbl)",
numberSuffix: "K",
theme: "fusion",
exportEnabled: 1 // to enable the export chart functionality
},
data: chartData
}
};
const events = {
// Add your events method here:
// Event name should be in small letters.
dataplotclick: (e, a) => {
Alert.alert(`You clicked on ${e.data.categoryLabel}`);
}
}
return (
<View style={styles.container}>
<Text>Fusioncharts</Text>
<ReactNativeFusionCharts
chartConfig={chartConfig}
events={events}
/>
<StatusBar style="auto" />
</View>
);
}
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: '#fff',
alignItems: 'center',
justifyContent: 'center',
marginTop: 50
},
});
Working with APIs
In this sample we can change the chart type dynamically using chart APIs.
import React, { Component } from 'react';
import { Platform, StyleSheet, Text, View, Button, Alert } from 'react-native';
import ReactNativeFusionCharts from 'react-native-fusioncharts';
export default class ChartRunTime extends Component {
constructor(props) {
super(props);
// Create a property(e.g: apiCaller) which will get attached to a function
// where you can pass Chart API methods you want to run.
this.apiCaller = null;
const chartConfig = {
type: 'column2d',
width: '100%',
height: '100%',
dataFormat: 'json',
dataSource: {
chart: {
caption: 'Recommended Portfolio Split',
subCaption: 'For a net-worth of $1M',
showValues: '1',
showPercentInTooltip: '0',
numberPrefix: '$',
enableMultiSlicing: '1',
theme: 'fusion',
exportEnabled: 1
},
data: [
{
label: 'Equity',
value: '300000'
},
{
label: 'Debt',
value: '230000'
},
{
label: 'Bullion',
value: '180000'
},
{
label: 'Real-estate',
value: '270000'
},
{
label: 'Insurance',
value: '20000'
}
]
}
};
this.state = {
chartConfig,
chartType: ''
}
}
changeType(type) {
this.setState({ chartType: type }, () => {
// Chart instance is available here.
// Passing js code to run chart api method.
this.apiCaller(`chartType('${type}')`); // This method accepts js code in string.
});
}
// Bind the argument from onInitialized with the property you created in your constructor
bindApiCaller(caller) {
// Now this.apiCaller will be a function where you can pass js code for the WebView
// to access the chart Object. See the method changeType.
this.apiCaller = caller;
if (this.state.chartType === '')
this.setState({ chartType: this.state.type });
}
render() {
return (
<View style={styles.container}>
<Text style={styles.header}>Change chart type at runtime</Text>
<View style={styles.chartContainer}>
<ReactNativeFusionCharts
chartConfig={this.state.chartConfig}
onInitialized={caller => {
this.bindApiCaller(caller);
}}
/>
</View>
<Text style={styles.info}>Press button to change chart type</Text>
<View style={styles.buttonContainer}>
<Button
disabled={
this.state.chartType === '' || this.state.chartType == 'column2d'
}
style={{ margin: 8 }}
title="Column2D"
onPress={() => this.changeType('column2d')}
/>
<Button
disabled={
this.state.chartType === '' || this.state.chartType == 'pie2d'
}
title="Pie2D"
onPress={() => this.changeType('pie2d')}
/>
<Button
disabled={
this.state.chartType === '' || this.state.chartType == 'bar2d'
}
title="Bar2D"
onPress={() => this.changeType('bar2d')}
/>
</View>
</View>
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
padding: 10
},
header: {
fontWeight: 'bold',
fontSize: 20,
textAlign: 'center',
paddingBottom: 10
},
chartContainer: {
height: 400,
borderColor: '#000',
borderWidth: 1
},
buttonContainer: {
padding: 10,
display: 'flex',
justifyContent: 'space-around',
flexDirection: 'row',
alignItems: 'center'
},
info: {
fontSize: 16,
textAlign: 'center',
marginTop: 5
}
});
Working with modules
In this sample we can add the modules dynamically e.g gantt, timeseries, powercharts etc
import React, { Component } from "react";
import { StyleSheet, View } from "react-native";
import ReactNativeFusionCharts from "react-native-fusioncharts";
export default class App extends Component {
constructor(props) {
super(props);
const chartConfig = {
type: "gantt", // your chart type goes here
width: "100%",
height: "400",
dataFormat: "json",
dataSource: { // your data goes here
// for gantt chart data please visit https://www.fusioncharts.com/dev/chart-attributes/gantt
}
};
this.state = {
chartConfig
};
}
render() {
const modules = ['gantt']; // module names goes here
return (
<View style={styles.container}>
<View style={styles.chartContainer}>
<ReactNativeFusionCharts
chartConfig={this.state.chartConfig}
modules={modules}
/>
</View>
</View>
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
padding: 10
},
chartContainer: {
height: '60%',
borderColor: "#000",
borderWidth: 1
}
});
In this sample we can add the theme modules dynamically e.g candy, carbon, gammel etc
import React, { Component } from 'react';
import { Platform, StyleSheet, Text, View, Alert } from 'react-native';
import ReactNativeFusionCharts from 'react-native-fusioncharts';
export default class ListenEvents extends Component {
constructor(props) {
super(props);
const chartConfig = {
type: 'column2d',
width: '100%',
height: '100%',
dataFormat: 'json',
dataSource: {
chart: {
caption: 'Countries With Most Oil Reserves [2017-18]',
subCaption: 'In MMbbl = One Million barrels',
xAxisName: 'Country',
yAxisName: 'Reserves (MMbbl)',
numberSuffix: 'K',
theme: 'carbon', // your theme name goes here
exportEnabled: 1
},
data: [
{ label: 'Venezuela', value: '290' },
{ label: 'Saudi', value: '260' },
{ label: 'Canada', value: '180' },
{ label: 'Iran', value: '140' },
{ label: 'Russia', value: '115' },
{ label: 'UAE', value: '100' },
{ label: 'US', value: '30' },
{ label: 'China', value: '30' }
]
}
};
this.state = {
chartConfig
};
}
render() {
const modules = ['carbon']; // theme module name
return (
<View style={styles.container}>
<Text style={styles.header}>Listen to events from chart</Text>
<View style={styles.chartContainer}>
<ReactNativeFusionCharts
chartConfig={this.state.chartConfig}
modules={modules}
/>
</View>
</View>
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
padding: 10
},
header: {
fontWeight: 'bold',
fontSize: 20,
textAlign: 'center',
paddingBottom: 10
},
chartContainer: {
height: 400,
borderColor: '#000',
borderWidth: 1
}
});
License Configuration
If you are using a licensed verison of fusioncharts and have a valid license key, add the license object by either creating a new file with your license configuration inside it and import it in app.js or add ‘global.licenseConfig’ object to the app.js file as shown below
import React, { Component } from "react";
import { StyleSheet, View } from "react-native";
import ReactNativeFusionCharts from "react-native-fusioncharts";
global.licenseConfig = {
key: "your key goes here",
creditLabel: false // true/false to show/hide watermark respectively
};
export default class App extends Component {
constructor(props) {
super(props);
const chartConfig = {
type: "column2D",
width: "100%",
height: "400",
dataFormat: "json",
dataSource: {
chart: {
caption: "Countries With Most Oil Reserves [2017-18]",
subCaption: "In MMbbl = One Million barrels",
xAxisName: "Country",
yAxisName: "Reserves (MMbbl)",
numberSuffix: "K",
theme: "fusion",
exportEnabled: 1
},
data: [
{ label: "Venezuela", value: "250" },
{ label: "Saudi", value: "260" },
{ label: "Canada", value: "180" },
{ label: "Iran", value: "140" },
{ label: "Russia", value: "115" },
{ label: "UAE", value: "100" },
{ label: "US", value: "30" },
{ label: "China", value: "30" }
],
},
};
this.state = {
chartConfig
};
}
render() {
return (
<View style={styles.container}>
<View style={styles.chartContainer}>
<ReactNativeFusionCharts
chartConfig={this.state.chartConfig}
/>
</View>
</View>
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
padding: 10
},
chartContainer: {
height: '60%',
borderColor: "#000",
borderWidth: 1
}
});
Usage and integration of FusionTime
From fusioncharts@3.13.3-sr.1
and react-native-fusioncharts@3.0.0
, You can visualize timeseries data easily on react.
Learn more about FusionTime here.
Consider the example below for integration of FusionTime
// In App.js
import React, { Component } from 'react';
import { AppRegistry, StyleSheet, Text, View, Platform } from 'react-native';
import ReactNativeFusionCharts from 'react-native-fusioncharts';
export default class App extends Component {
constructor(props) {
super(props);
const chartConfig = {
type: 'timeseries',
width: '100%',
height: '100%',
dataFormat: 'json',
dataSource: {
data: null,
caption: {
text: 'Sales Analysis'
},
subcaption: {
text: 'Grocery'
},
yAxis: [
{
plot: {
value: 'Grocery Sales Value',
type: 'line'
},
format: {
prefix: '$'
},
title: 'Sale Value'
}
]
},
schemaJson: null,
dataJson: null
};
this.state = {
chartConfig
}
}
componentDidMount() {
this.fetchDataAndSchema();
}
fetchDataAndSchema() {
const jsonify = res => res.json();
const dFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/data/line-chart-with-time-axis-data.json'
).then(jsonify);
// This is the remote url to fetch the schema.
const sFetch = fetch(
'https://s3.eu-central-1.amazonaws.com/fusion.store/ft/schema/line-chart-with-time-axis-schema.json'
).then(jsonify);
Promise.all([dFetch, sFetch]).then(res => {
const data = res[0];
const schema = res[1];
const updatedChartConfig = {...this.state.chartConfig, dataJson: data, schemaJson: schema}
this.setState({ chartConfig: updatedChartConfig });
});
}
render() {
const modules = ['timeseries'];
return (
<View style={styles.container}>
<Text style={styles.heading}>
FusionCharts Integration with React Native
</Text>
<View style={styles.chartContainer}>
<ReactNativeFusionCharts
chartConfig={this.state.chartConfig}
modules={modules}
/>
</View>
</View>
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
padding: 10
},
heading: {
fontSize: 20,
textAlign: 'center',
marginBottom: 10
},
chartContainer: {
height: 500
}
});
Going Beyond Charts
- Explore 20+ pre-built business specific dashboards for different industries like energy and manufacturing to business functions like sales, marketing and operations here.
- See Data Stories built using FusionCharts’ interactive JavaScript visualizations and learn how to communicate real-world narratives through underlying data to tell compelling stories.
For Contributors
- Clone the repository.
- Install dependencies
- Run
npm start
to start React Native Packager server. - Run on Android or iOS emulator.
$ git clone https://github.com/fusioncharts/react-native-fusioncharts.git
$ cd react-native-fusioncharts
$ npm i
$ npm start
$ emulator @<name_of_android_emulator>
$ npm run android [to run on Android platform]
$ npm run ios [to run on iOS platform]
To create a build & publish on MyGet/NPM, run:
$ npm run build:FC
Licensing
The FusionCharts React Native integration component is open-source and distributed under the terms of the MIT/X11 License. However, you will need to download and include FusionCharts library in your page separately, which has a separate license.