2014-06-29 19:35:49 +02:00
---
title: Notes
anchor: notes
---
2016-04-27 20:48:05 +02:00
### Previous versions
2016-08-08 05:08:13 +02:00
Version 2 has a completely different API than earlier versions.
Most earlier version options have current equivalents or are the same.
Please use the documentation that is available on [chartjs.org ](http://www.chartjs.org/docs/ ) for the current version of Chart.js.
Please note - documentation for previous versions are available on the GitHub repo.
2016-04-27 20:48:05 +02:00
- [1.x Documentation ](https://github.com/chartjs/Chart.js/tree/v1.1.1/docs )
2014-06-29 19:35:49 +02:00
### Browser support
2016-04-23 15:34:57 +02:00
Chart.js offers support for all browsers where canvas is supported.
2014-06-29 19:35:49 +02:00
2016-04-25 16:47:36 +02:00
Browser support for the canvas element is available in all modern & major mobile browsers < a href = "http://caniuse.com/#feat=canvas" target = "_blank" > (http://caniuse.com/#feat=canvas)< / a > .
2014-06-29 19:35:49 +02:00
2016-05-18 14:32:09 +02:00
Thanks to < a href = "https://browserstack.com" target = "_blank" > BrowserStack< / a > for allowing our team to test on thousands of browsers.
2014-06-29 19:35:49 +02:00
### Bugs & issues
2016-05-02 16:01:26 +02:00
Please report these on the GitHub page - at < a href = "https://github.com/chartjs/Chart.js" target = "_blank" > github.com/chartjs/Chart.js< / a > . If you could include a link to a simple < a href = "http://jsbin.com/" target = "_blank" > jsbin< / a > or similar to demonstrate the issue, that'd be really helpful.
2014-06-29 19:35:49 +02:00
### Contributing
2016-08-08 05:08:13 +02:00
New contributions to the library are welcome, but we ask that you please follow these guidelines:
- Use tabs for indentation, not spaces.
- Only change the individual files in `/src` .
2016-09-02 21:56:22 +02:00
- Check that your code will pass `eslint` code standards, `gulp lint` will run this for you.
2016-08-08 05:08:13 +02:00
- Check that your code will pass tests, `gulp test` will run tests for you.
- Keep pull requests concise, and document new functionality in the relevant `.md` file.
- Consider whether your changes are useful for all users, or if creating a Chart.js plugin would be more appropriate.
2014-06-29 19:35:49 +02:00
### License
2016-08-08 05:08:13 +02:00
Chart.js is < a href = "https://github.com/chartjs/Chart.js" target = "_blank" > open source< / a > and available under the < a href = "http://opensource.org/licenses/MIT" target = "_blank" > MIT license< / a > .
### Charting Library Comparison
Library Features
| Feature | Chart.js | D3 | HighCharts | Chartist |
| ------- | -------- | --- | ---------- | -------- |
2016-10-08 04:14:25 +02:00
| Completely Free | ✓ | ✓ | | ✓ |
| Canvas | ✓ | | | |
| SVG | | ✓ | ✓ | ✓ |
| Built-in Charts | ✓ | | ✓ | ✓ |
| 8+ Chart Types | ✓ | ✓ | ✓ | |
| Extendable to Custom Charts | ✓ | ✓ | | |
| Supports Modern Browsers | ✓ | ✓ | ✓ | ✓ |
| Extensive Documentation | ✓ | ✓ | ✓ | ✓ |
| Open Source | ✓ | ✓ | ✓ | ✓ |
2016-08-08 05:08:13 +02:00
Built in Chart Types
| Type | Chart.js | HighCharts | Chartist |
| ---- | -------- | ---------- | -------- |
2016-10-08 04:14:25 +02:00
| Combined Types | ✓ | ✓ | |
| Line | ✓ | ✓ | ✓ |
| Bar | ✓ | ✓ | ✓ |
| Horizontal Bar | ✓ | ✓ | ✓ |
| Pie/Doughnut | ✓ | ✓ | ✓ |
| Polar Area | ✓ | ✓ | |
| Radar | ✓ | | |
| Scatter | ✓ | ✓ | ✓ |
| Bubble | ✓ | | |
| Gauges | | ✓ | |
| Maps (Heat/Tree/etc.) | | ✓ | |
2016-08-08 05:08:13 +02:00
2016-08-09 16:34:59 +02:00
### Popular Plugins
There are many plugins that add additional functionality to Chart.js. Some particularly notable ones are listed here. In addition, many plugins can be found on the [Chart.js GitHub organization ](https://github.com/chartjs ).
2016-11-17 10:29:36 +01:00
- < a href = "https://github.com/chartjs/chartjs-plugin-annotation" target = "_blank" > chartjs-plugin-annotation.js</ a > - Draw lines and boxes on chart area
- < a href = "https://github.com/chartjs/chartjs-plugin-deferred" target = "_blank" > chartjs-plugin-deferred.js</ a > - Defer initial chart update until chart scrolls into viewport
- < a href = "https://github.com/compwright/chartjs-plugin-draggable" target = "_blank" > chartjs-plugin-draggable.js</ a > - Makes select chart elements draggable with the mouse
- < a href = "https://github.com/chartjs/chartjs-plugin-zoom" target = "_blank" > chartjs-plugin-zoom.js</ a > - Enable zooming and panning on charts
2016-08-09 16:34:59 +02:00
- < a href = "https://github.com/chartjs/Chart.BarFunnel.js" target = "_blank" > Chart.BarFunnel.js</ a > - Adds a bar funnel chart type
- < a href = "https://github.com/chartjs/Chart.LinearGauge.js" target = "_blank" > Chart.LinearGauge.js</ a > - Adds a linear gauge chart type
2016-11-17 10:29:36 +01:00
- < a href = "https://github.com/chartjs/Chart.smith.js" target = "_blank" > Chart.Smith.js</ a > - Adds a smith chart type
2016-08-09 16:34:59 +02:00
2016-08-08 05:08:13 +02:00
### Popular Extensions
2016-08-09 16:34:59 +02:00
There are many extensions which are available for use with popular frameworks. Some particularly notable ones are listed here.
2016-08-08 05:08:13 +02:00
#### Angular
2016-08-08 05:31:15 +02:00
- < a href = "https://github.com/jtblin/angular-chart.js" target = "_blank" > angular-chart.js</ a >
- < a href = "https://github.com/carlcraig/tc-angular-chartjs" target = "_blank" > tc-angular-chartjs</ a >
- < a href = "https://github.com/petermelias/angular-chartjs" target = "_blank" > angular-chartjs</ a >
- < a href = "https://github.com/earlonrails/angular-chartjs-directive" target = "_blank" > Angular Chart-js Directive</ a >
2016-08-08 05:08:13 +02:00
#### React
2016-09-09 23:17:31 +02:00
- < a href = "https://github.com/topdmc/react-chartjs2" target = "_blank" > react-chartjs2</ a >
- < a href = "https://github.com/gor181/react-chartjs-2" target = "_blank" > react-chartjs-2</ a >
2016-08-08 05:08:13 +02:00
#### Django
2016-08-08 05:31:15 +02:00
- < a href = "https://github.com/novafloss/django-chartjs" target = "_blank" > Django Chartjs</ a >
2016-08-08 05:08:13 +02:00
#### Ruby on Rails
2016-08-08 05:31:15 +02:00
- < a href = "https://github.com/airblade/chartjs-ror" target = "_blank" > chartjs-ror</ a >
2016-08-08 05:08:13 +02:00
#### Laravel
2016-08-08 05:31:15 +02:00
- < a href = "https://github.com/fxcosta/laravel-chartjs" target = "_blank" > laravel-chartjs</ a >