Simple HTML5 Charts using the <canvas> tag
Clone or download
bakert and etimberg Correct spelling mistake. (#5831)
Use a simpler phrase for this heading.
Latest commit ecf64d3 Nov 15, 2018
Permalink
Failed to load latest commit information.
.github Use comment for pull request template (#5595) Jun 26, 2018
docs Correct spelling mistake. (#5831) Nov 15, 2018
samples Make bar styling options scriptable (#5780) Nov 12, 2018
scripts Deploy to GitHub pages (#4256) May 19, 2017
src Make bar styling options scriptable (#5780) Nov 12, 2018
test Add regression test for legend layout issue (#5776) Nov 14, 2018
.codeclimate.yml Use the Chart.js shared ESLint config (#5112) Jan 6, 2018
.editorconfig Change .editorconfig to include final newlines (#5827) Nov 12, 2018
.eslintignore Update git ignore to make it easier to switch between branches. Add c… Feb 14, 2016
.eslintrc.yml Setup HTML and JS linters for samples (#5195) Feb 3, 2018
.gitignore Ignore package-lock.json (#5138) Jan 11, 2018
.htmllintrc Make `Chart.Animation/animations/Tooltip` importable (#5382) Apr 2, 2018
.npmignore Make Travis to release the npm package Jun 18, 2016
.travis.yml Suppress coveralls errors if run from fork (#4699) Nov 1, 2017
LICENSE.md Update license year and copyright holders (#5053) Dec 31, 2017
MAINTAINING.md Fix broken links in Maintaining.md Sep 13, 2016
README.md clarify moment.js included in bundle cannot be used outside of chartjs ( Jun 4, 2018
book.json Improve title of generated documentation (#5256) Feb 16, 2018
composer.json Add composer.json Mar 14, 2016
gulpfile.js Make bar styling options scriptable (#5780) Nov 12, 2018
karma.conf.js Add support for *.js test fixture config (#5777) Oct 20, 2018
package.json Bump version to 2.7.3 Oct 15, 2018

README.md

Chart.js

travis coveralls codeclimate slack

Simple HTML5 Charts using the canvas element chartjs.org

Installation

You can download the latest version of Chart.js from the GitHub releases or use a Chart.js CDN.

To install via npm:

npm install chart.js --save

To install via bower:

bower install chart.js --save

Selecting the Correct Build

Chart.js provides two different builds for you to choose: Stand-Alone Build, Bundled Build.

Stand-Alone Build

Files:

  • dist/Chart.js
  • dist/Chart.min.js

The stand-alone build includes Chart.js as well as the color parsing library. If this version is used, you are required to include Moment.js before Chart.js for the functionality of the time axis.

Bundled Build

Files:

  • dist/Chart.bundle.js
  • dist/Chart.bundle.min.js

The bundled build includes Moment.js in a single file. You should use this version if you require time axes and want to include a single file. You should not use this build if your application already included Moment.js. Otherwise, Moment.js will be included twice which results in increasing page load time and possible version compatibility issues. The Moment.js version in the bundled build is private to Chart.js so if you want to use Moment.js yourself, it's better to use Chart.js (non bundled) and import Moment.js manually.

Documentation

You can find documentation at www.chartjs.org/docs. The markdown files that build the site are available under /docs. Previous version documentation is available at www.chartjs.org/docs/latest/developers/#previous-versions.

Contributing

Before submitting an issue or a pull request, please take a moment to look over the contributing guidelines first. For support using Chart.js, please post questions with the chartjs tag on Stack Overflow.

Building

Instructions on building and testing Chart.js can be found in the documentation.

Thanks

  • BrowserStack for allowing our team to test on thousands of browsers.
  • @n8agrin for the Twitter handle donation.

License

Chart.js is available under the MIT license.