Skip to content

Easy to use and highly customizable charts library for iOS

License

Notifications You must be signed in to change notification settings

istemit/FLCharts

 
 

Repository files navigation

FLCharts

FLCharts

Version Platforms License Carthage compatible Swift Xcode 11.0+ iOS 11.0+ SPM

FLCharts is an easy-to-use library to build highly customizable bar, line and pie charts. It allows you to create your own chart bar UIView and use it to display data in the chart.
Additionally FLCharts allows you to provide a custom HighlightedView to show the highlighted bar contents on top of the chart.
Embed effortlessly your chart in a FLCard alogside with a title, an average vlue view and additional behaviours.

Table of Contents

Requirements

  • Xcode 11 / Swift 5
  • iOS >= 11.0

Installation

FLCharts is available through SPM, CocoaPods and Carthage

Swift Package Manager

In XCode go to File -> Add Packages...

Search for https://github.com/francescoleoni98/FLCharts and click Add Package.

Select to which target you want to add it and select Add Package.

CocoaPods

FLCharts is available through CocoaPods. To install it, add the following line to your Podfile:

pod 'FLCharts'

Then run pod install

Carthage

To install it with Carthage, in your Cartfile add:

github "francescoleoni98/FLCharts"

Then run carthage update

In XCode > Build phases click the plus button on top left > New Run Script Phases.
Then in Run Script > Shell script window > add /usr/local/bin/carthage copy-frameworks.
Run Script > Input file window > add $(SRCROOT)/Carthage/Build/iOS/FLCharts.framework.

Then, go to $project_dir/Carthage/Build/iOS and drag the folder FLCharts.framework into your Xcode Project > Your Target > Frameworks, Libraries and Embedded Content.

Example

Here you can find a guide about how to setup a bar chart using FLCharts:
https://medium.com/@leonifrancesco/set-up-a-basic-bar-chart-using-flcharts-swift-d2f615a10d0b

Features

  • Animations for chart bars
  • Customizable Axes (both x and y axis)
  • Dragging / Panning (with touch-gesture)
  • Highlighting values (with customizable popup-views)
  • Create custom cards with embedded chart and more features
  • Scroll through chart while highlighted to change highlighted bar
  • Fully customizable (bar colors, axes color, background, average value, dashed lines, ...)

Configurations

FLChart is highly customizable. You can choose which property to modify through the .config property.

let axisLabelConfig = FLAxisLabelConfig(color: .black,
                                        font: .preferredFont(forTextStyle: .body))
                         
chart.config = ChartConfig(axesLabels: axisLabelConfig)

Docs

You can build FLCharts documentation directly in XCode.
In XCode go to Product -> Build Documentation, once XCode has finished building, the documentation will appear.

Examples

  • Bar Chart

bar chart

  • Multivalue Bar Chart

multivalue bar chart

  • Highlighted Bar

highlighted bar

  • Average view

average view

  • Bar chart embedded in FLCard

bar chart embedded in FLCard

  • Dark mode

dark mode

  • Line Chart X and Y Segments

x y segments

  • Line Chart

line chart

  • Scatter Chart

scatter chart

  • Pie Chart

pie chart

  • Radar Chart

radar chart

Animations

  • Panning while highlighted

alt tag

  • Chart animation

alt tag

  • Scrolling behaviour with average and highlighted views

alt tag

Author

Francesco Leoni | [email protected]
francescoleoni98 | https://github.com/francescoleoni98

License

FLCharts is available under the MIT license. See the LICENSE file for more info.

My Apps

Linkboard - Bookmarks Manager

About

Easy to use and highly customizable charts library for iOS

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 99.0%
  • Ruby 1.0%