+0
Daily
5,900
stars
1,538
forks
267
watchers
526
prs
1,346
issues
13
releases
README
flot
About
flot is a JavaScript plotting library for engineering and scientific
applications derived from Flot:
Take a look at the the examples in examples/index.html; they should give a good
impression of what flot can do, and the source code of the examples is probably
the fastest way to learn how to use flot.
Installation
Just include the JavaScript file after you've included jQuery.
Generally, all modern browsers are supported.
You need at least jQuery 1.2.6, but try at least 1.3.2 for interactive
charts because of performance improvements in event handling.
Basic usage
Create a placeholder div to put the graph in:
html
You need to set the width and height of this div, otherwise the plot
library doesn't know how to scale the graph. You can do it inline like
this:
html
You can also do it with an external stylesheet. Make sure that the
placeholder isn't within something with a display:none CSS property -
in that case, Flot has trouble measuring label dimensions which
results in garbled looks and might have trouble measuring the
placeholder dimensions which is fatal (it'll throw an exception).
Then when the div is ready in the DOM, which is usually on document
ready, run the plot function:
js
$.plot($("placeholder"), data, options);
Here, data is an array of data series and options is an object with
settings if you want to customize the plot. Take a look at the
examples for some ideas of what to put in or look at the
API reference. Here's a quick example that'll draw a line
from (0, 0) to (1, 1):
js
$.plot($("placeholder"), [ [[0, 0], [1, 1]] ], { yaxis: { max: 1 } });
The plot function immediately draws the chart and then returns a plot
object with a couple of methods.
Documentation and examples
API Documentation is available here: API reference
About how the plugins work: Plugins
High level overview on how interactions are handled internally: Interactions
Examples are included in the examples folder of this repository, but they can be tried out online as well: Examples
CircleCI
CircleCI is used in this repo to run dont-break,
which checks if the current version of flot breaks unit tests on specified dependent projects.Top issues
#140Support for dashed lines31 comments · 2012-09-28#238Multi series bar charts28 comments · 2012-09-28#164Long x-axis labels28 comments · 2012-09-28#221Ability to save the entire plot as an image24 comments · 2012-09-28#105Logarithmic scales22 comments · 2012-09-28#1014Tick Label Width is 0 for new plot21 comments · 2013-04-11#106Support for bar charts with keys instead of x-axis values20 comments · 2012-09-28#305Feature request: Splines18 comments · 2012-09-28
Latest release
v0.8.3 v0.8.3 2014-04-21Changes - Updated example code to avoid encouraging unnecessary re-plots. (patch by soenter, pull request 1221) Bug fixes - Added a work-around to disable the allocation of extra space for first and last axis ticks, allowing plots to span the full width of their container. A proper solution for this bug will be implemented in the 0.9 release. (reported by Josh Pigford and andig, issue 1212, pull request 1290) - Fixed a regression introduced in 0.8.1, where the last tick label would sometimes wrap rather than extending the plot's offset to create space. (reported by Elite Gamer, i