Big welcome by the Chartist Guy

Checkout the documentation site at http://gionkunz.github.io/chartist-js/

Checkout this lightning talk that gives you an overview of Chartist in 5 minutes https://www.youtube.com/watch?v=WdYzPhOB_c8

Guest talk of the Chartist.js Guy at the Treehouse Show https://www.youtube.com/watch?v=h9oH0iDaZDQ&t=2m40s

Chartist.js is a simple responsive charting library built with SVG. There are hundreds of nice charting libraries already out there, but they are either:

• not responsive
• use the wrong technologies for illustration (canvas)
• are not flexible enough while keeping the configuration simple
• are not friendly to your own code
• are not friendly to designers
• have unnecessary dependencies to monolithic libraries
• more annoying things

That's why we started Chartist.js and our goal is to solve all of the above issues.

What is it made for?

Chartist's goal is to provide a simple, lightweight and unintrusive library to responsively craft charts on your website. It's important to understand that one of the main intentions of Chartist.js is to rely on standards rather than providing it's own solution to a problem which is already solved by those standards. We need to leverage the power of browsers today and say good bye to the idea of solving all problems ourselves.

Chartist works with inline-SVG and therefore leverages the power of the DOM to provide parts of its functionality. This also means that Chartist does not provide it's own event handling, labels, behaviors or anything else that can just be done with plain HTML, JavaScript and CSS. The single and only responsibility of Chartist is to help you drawing "Simple responsive Charts" using inline-SVG in the DOM, CSS to style and JavaScript to provide an API for configuring your charts.

Example site

You can visit this Site http://gionkunz.github.io/chartist-js/ which is in fact a build of the current project. We are still developing and constantly add features but you can already use Chartist.js in your projects as we have reached a stable and reliable state already.

Version notes

We are currently still heavily developing in order to make Chartist.js better. Your help is needed! Please contribute to the project if you like the idea and the concept and help us to bring nice looking responsive open-source charts to the masses.

Important missing stuff

1. Jasmine Tests!
2. Documentation: JSDoc, Getting started documentation and landing page
3. Better accessibility using ARIA and other optimizations
4. Better interfaces to the library (i.e. jQuery with data-* attributes for configuration), Angular.js directive etc.
5. Richer Sass / CSS framework
6. Other charts types (spider etc.)

Contribution

We are looking for people who share the idea of having a simple, flexible charting library that is responsive and uses modern and future-proof technologies. The goal of this project is to create a responsive charting library where developers have their joy in using it and designers love it because of the designing flexibility they have.

Contribute if you like the Chartist Guy!

v0.9.4 - 06 Aug 2015

• Added axes to all events where they are available in context to provide better API convenience when developing plugins
• Consider additional parameters of SVG elem when called with DOM node

v0.9.3 - 05 Aug 2015

• Added better check for undefined values in bar chart, fixes #400
• Fixed issue with SVG feature check within Svg module (Thanks to Markus Gruber !)

v0.9.2 - 02 Aug 2015

• Enabled bar charts to use dynamic axes fixes #363, fixes #355
• Added axis title plugin to plugins page (Thanks to @alexstanbury !)
• Added a label group for Pie charts to prevent occlusion by slices (Thanks to Anthony Jimenez!)
• Added better handling for multi values when writing custom attributes, fixes #379

v0.9.1 - 24 Jun 2015

• Fixed bug with areaBase narrowing process in area charts, fixes #364
• Fixed bug on bar chart where wrong offset was used (axis offset), fixes #347 (Thanks to @amsardesai !)
• Fixed bug with namespace attributes that caused duplication of SVG element on updates in old browsers (Thanks to @radist2s !)

v0.9.0 - 10 Jun 2015

• Major refactoring of axis and projection code, added possibility to configure axes when creating a chart
• Added areaBase to series options override in line chart, fixes #342
• Throwing up in infinite loop for edge cases and during development
• Documentation: Added documentation for axis configuration and getting started guide for custom axes

v0.8.3 - 07 Jun 2015

• Greatly reduced CSS selector complexity and split slice into slice-pie and slice-donut
• Added more robust detach mechanism that takes async initialization into account
• Added better handling for area drawing with segmented paths, fixes #340
• Documentation: Added getting started guide for styling charts

v0.8.2 - 02 Jun 2015

• Fixed broken release 0.8.1

v0.8.1 - 02 Jun 2015 (BROKEN!)

• Added new option labelPosition for Pie charts to have better control over label placement, fixes #315
• Added default styles for alignment-baseline
• Added better support for undefined values in bar charts
• Refactored getHighLow to use recursion in order to enable more dynamic array structures and better edge case management
• Fixed issue with Chartist.rho that caused endless loop when called with 1, fixes #318

v0.8.0 - 10 May 2015

• Added new option to bar charts to allow a series distribution and use a simple one dimensional array for data (#209)
• Added option for label placement and refactored label positioning code (#302)
• Added option to only use integer numbers in linear scale axis (#77)
• Added possibility to add series configuration on line chart to override specific options on series level (#289, #168)
• Added functionality to handle holes in line charts (#294)
• Added step interpolation for line charts
• Added default styles for bar and horizontal bar labels that make more sense (#303)
• Added series data and meta information to events (#293)
• Changed line chart behavior to draw points from interpolated values (#295)
• Removed restriction to SVGElements so Chartist.Svg can be used for HTML DOM elements (#261)
• Refactored and simplified axis creation, also includes updated CSS label handling
• Refactored getDataArray for simplification and fixed type conversion issue with data arrays for pie charts
• Centralized high/low calculations in getHighLow() method and added support for empty charts. Thanks @scthi !
• Fixed bug in pie chart where meta was only added when series name was specified
• Fixed bug where special condition to check single value should also include object value notation (#265)
• Fixed bug with Chartist.extend when null property is extended
• Fixed bug with Firefox dying with a DOM exception when calling getBBox() on an invisible node. Thanks @scthi !
• Switched from object literal accessor definition to regular function (#278)

v0.7.4 - 19 Apr 2015

• Enhanced documentation site (Accessibility plugin, live example eval, fixed path to Sass settings, better HTML example of how to include Chartist, example how to include multiple charts on one page)
• Added Arc to Chartist.Svg.Path
• Refactored Chartist.Pie to make use of Svg.Path and expose path in events
• Closing path of Pie if not a donut for correct strokes
• Exposing axis objects in created event
• Changed grid event to use axis object instead of string

v0.7.3 - 27 Feb 2015

• Fixed bugs in the chart.update method
• Fixed rounding precision issues in order of magnitude calculation
• Fixed bug in Chartist.extend which caused merge problems from object properties into non-objects
• Added possibility to use chartPadding with a padding object that contains top, right, bottom and left properties

v0.7.2 - 12 Feb 2015

• Added new line smoothing / interpolation module for configurable line smoothing
• Added simple line smoothing. Thanks @danieldiekmeier !
• Removed some unused internal code

v0.7.1 - 02 Feb 2015

• Bug fix where some files where not included in dist version of Chartist which made v0.7.0 unusable.

v0.7.0 - 01 Feb 2015

• This version introduces a new option in the bar charts to draw them horizontally
• Underlying changes for axis model that allows flexible value projection and removes code duplication
• Added SVG Path API for manipulating SVG paths. This can be used in animations or to transform the output by Chartist further.
• The fullWidth and centerBars options were removed from the bar chart
• Updating chart after options update enables the use of 'print' media query in responsive options to have a quick redraw before printing. This only works in Chrome 40 so far
• Fixed issues with 0 values in series object data notation

v0.6.1 - 23 Jan 2015

• Fixed bug that prevented data events to be captured
• Fixed bug with update function called in the same call stack as chart constructor

v0.6.0 - 17 Jan 2015

• Added 14 default colors for colored series
• Added data event that allows you to transform the data before it gets rendered in Chartist. This is also useful for plugin authors that would like to create plugins which modify data.
• Possibility to specify meta data in the data object passed to Chartist that will be written to custom attributes into the DOM.
• Possibility to specify options when calling chart.update in order to override the current options with new ones
• Fixed some missing entries in the bower ignore section to exclude the documentation site as well as the grunt tasks
• Fixed issue when Chartist is initialized in a container that already contains SVG

v0.5.0 - 14 Dec 2014

• Added new option for line and bar chart to use full width of the chart area by skipping the last grid line
• Added new option for bar chart to create stacked bar charts
• All chart update functions now accepts an optional data parameter that allows to update an existing chart with new data
• Fix for an error when charts get re-constructed on the same element and in the same call stack

v0.4.4 - 11 Dec 2014

• Fixed NS_ERROR_FAILURE error in Firefox and added graceful handling of unsupported SMIL animations (i.e. in foreignObjects)

v0.4.3 - 27 Nov 2014

• Updated plugin architecture for convenience reasons and better support for modularization

v0.4.2 - 27 Nov 2014

• Included first version of Chartist.js Plugin mechanism
• Major refactoring of development stack (thanks @Autarc !)
• Removed unused functions in Chartist.Core

v0.4.1 - 21 Nov 2014

• Added more functionality to Chartist.Svg: select child elements, parent, root as well as a Svg list wrapper with delegation functions
• Fixed bug in strip unit
• Added classes to the label and grid gorups
• Added this as return value so calls to chart can be chained up easily

v0.4.0 - 17 Nov 2014

• Added new animation API for SMIL animations
• Added possibility to add event handlers with asterisk that will be triggerd on all events including the event name in the cb function
• Added possibility to pass DOM node to SVG constructor so you can wrap existing SVG nodes into a Chartist.Svg element
• Fixed svg recycling on re-creation
• Fixed resize listener detach that wasn't working properly
• Refactored Chartist.Svg to use Chartist.Class
• Including event when line and area is drawn
• Changed default scaleMinSpace to 20 to be more mobile friendly
• Fixed bug with line area base