/react-native-ios-charts

Bringing iOS Charts to React Native

Primary LanguageSwiftMIT LicenseMIT

react-native-ios-charts

npm version npm downloads

Bringing iOS Charts to React Native.

Image of all charts

Check out the ChartsExplorer in the examples folder

Introduction

The aim of this library is to provide reusable React Native components that can graph charts like Bar, Line, Scatter, Combined, Pie, Candle, Bubble from the awesome ios-charts library.

Installation

The minimum deployment target should be set to iOS 8.0 or greater

  1. Run npm install --save react-native-ios-charts
  2. Add all the files under node_modules/react-native-ios-charts/RNiOSCharts.
  3. When you add the files XCode should prompt you to create a bridging header if you haven't done so already. Create it and import the RCTViewManager.h. It should look something like this.
#import "RCTViewManager.h"

3.5. You can use CocoaPods and skip steps 4-6. Just add a Podfile to your ios directory with the following content. Then run pod install and open the generated .xcworkspace from now on in xcode.

use_frameworks!

target 'MyApp' do
  pod 'SwiftyJSON', '2.3.1'
  pod 'Charts', '2.2.3'
end
  1. Install SwiftyJSON and iOS Charts libraries and add SwiftyJSON.xcodeproj and Charts.xcodeproj files to your project.
  2. Under Build Phases, under Link Binary With Libraries, click the plus sign and add SwiftyJSON.framework and Charts.framework.
  3. Add the SwiftyJSON.framework and Charts.framework to the Embedded Binaries section in your app.
  4. In your project's build settings, go to build options and change the Embedded Content Contains Swift Code to Yes.

Usage

Currently supported charts:

Example code:

var { BarChart } = require('react-native-ios-charts');

var MyComponent = React.createClass({
  render: function() {
    return (
      <View style={styles.container}>
        <BarChart
          config={{
            dataSets: [{
              values: [1, 2, 3, 10],
              colors: ['green'],
              label: '2015',
            }, {
              values: [3, 2, 1, 5],
              colors: ['red'],
              label: '2014',
            }],
            labels: ['a', 'b', 'c', 'd'],
          }}
          style={styles.chart}
        />
      </View>
    );
  }
});

var styles = StyleSheet.create({
  chart: {
    width: 200,
    height: 200
  }
})

Roadmap

  • Support for all charts
  • Examples
  • Support for all chart properties
  • Documentation

License

The MIT License (MIT)

Copyright (c) 2016 Jose E. Padilla

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.