Plottable is a library of chart components for creating flexible, custom charts for websites. It is built on top of D3.js and provides higher-level pieces, like plots, gridlines, and axes. As such, it's easier to quickly build charts than with D3, and the charts are much more flexible than standard-template charts provided by charting libraries. You can think of Plottable as a "D3 for Charts" — it is not a charting library but rather a library of chart components. Check out examples of Plottable on our website's examples page.
Plottable's core philosophy is "Composition over Configuration", so a lot of the API flexibility is in choosing which
Components to use, and how to arrange them in
Tables, rather than setting high-level properties on the charts. If you find you need a feature that doesn't exist, consider writing a new
Component that implements the functionality. This way, you can get your custom functionality and still benefit from the rest of the library.
- Get Plottable:
npm install --save plottable
yarn add plottable
- Check out examples
- Read the tutorials
- Visit the website, plottablejs.org
Upgrading to v1.0.0
If you are upgrading from a pre-v1.0.0 version of Plottable to v1.0.0 or later, please use the Upgrade Guide on the wiki.
Upgrading to v2.0.0
Check out the full list of changes between v1.16.2 and v2.0.0.
Upgrading to v3.0.0
Check out the full list of changes between v2.9.0 and v3.0.0.
We Want To Help!
If you run into any problems using Plottable, please let us know. We want Plottable to be easy-to-use, so if you are getting confused, it is our fault, not yours. Create an issue and we'll be happy to help you out, or drop by our Gitter room.
- Clone the repo
- Install local dependencies
yarn buildto build the dependencies
yarn startand it will spin up a server (pointed at http://localhost:9999) and begin compiling the typescript code
- Navigate to
http://localhost:9999/quicktests/and choose a directory to view visual tests
- Write your code
- Add tests for new functionality, and please add some quicktests too
yarn testand verify it completes with no warnings or failures
- Submit a pull request and sign the CLA when prompted by our bot