Chart.js/docs/10-Notes.md

98 lines
3.5 KiB
Markdown
Raw Normal View History

2014-06-29 19:35:49 +02:00
---
title: Notes
anchor: notes
---
2016-04-27 20:48:05 +02:00
### Previous versions
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
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
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`.
- Check that your code will pass `jshint` code standards, `gulp jshint` will run this for you.
- 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
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 |
| ------- | -------- | --- | ---------- | -------- |
| Completely Free | ✓ | ✓ | | ✓ |
| Canvas | ✓ | | | |
| SVG | | ✓ | ✓ | ✓ |
| Built-in Charts | ✓ | | ✓ | ✓ |
| 8+ Chart Types | ✓ | ✓ | ✓ | |
| Extendable to Custom Charts | ✓ | ✓ | | |
| Supports Modern Browsers | ✓ | ✓ | ✓ | ✓ |
| Extensive Documentation | ✓ | ✓ | ✓ | ✓ |
| Open Source | ✓ | ✓ | ✓ | ✓ |
Built in Chart Types
| Type | Chart.js | HighCharts | Chartist |
| ---- | -------- | ---------- | -------- |
| Combined Types | ✓ | ✓ | |
| Line | ✓ | ✓ | ✓ |
| Bar | ✓ | ✓ | ✓ |
| Horizontal Bar | ✓ | ✓ | ✓ |
| Pie/Doughnut | ✓ | ✓ | ✓ |
| Polar Area | ✓ | ✓ | |
| Radar | ✓ | | |
| Scatter | ✓ | ✓ | ✓ |
| Bubble | ✓ | | |
| Gauges | | ✓ | |
| Maps (Heat/Tree/etc.) | | ✓ | |
### Popular Extensions
There are many extensions which are available for use with popular frameworks. Some particularly notable ones are listed here:
#### Angular
- https://github.com/carlcraig/tc-angular-chartjs
- https://github.com/petermelias/angular-chartjs
- https://github.com/earlonrails/angular-chartjs-directive
#### React
- https://github.com/jhudson8/react-chartjs/tree/chartjs-v2
#### Django
- https://github.com/novafloss/django-chartjs
#### Ruby on Rails
- https://github.com/airblade/chartjs-ror
#### Laravel
- https://github.com/fxcosta/laravel-chartjs