Skip to content
This repository

Attractive JavaScript charts for jQuery

branch: master
Octocat-spinner-32 examples Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 .gitignore Add basic Travis CI setup with jshint test. February 15, 2013
Octocat-spinner-32 .travis.yml Fix travis config. YAML forbids tabs. February 15, 2013
Octocat-spinner-32 API.md Fix line wrapping and grammar. November 05, 2013
Octocat-spinner-32 CONTRIBUTING.md Mandate jsDoc comments for file/function headers. November 02, 2013
Octocat-spinner-32 FAQ.md Cleanup and markup standardization. July 16, 2012
Octocat-spinner-32 LICENSE.txt Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 Makefile Add basic Travis CI setup with jshint test. February 15, 2013
Octocat-spinner-32 NEWS.md Updated version number to 0.8.3-alpha. December 21, 2013
Octocat-spinner-32 PLUGINS.md fix example (syntax error and indenting) February 20, 2013
Octocat-spinner-32 README.md Change [olson] to http link July 03, 2013
Octocat-spinner-32 component.json Updated version number to 0.8.3-alpha. December 21, 2013
Octocat-spinner-32 excanvas.js Update excanvas and remove previous eventholder work-around to fix ho… May 13, 2011
Octocat-spinner-32 excanvas.min.js Update excanvas and remove previous eventholder work-around to fix ho… May 13, 2011
Octocat-spinner-32 flot.jquery.json Updated version number to 0.8.3-alpha. December 21, 2013
Octocat-spinner-32 jquery.colorhelpers.js Slight cleanup / optimization for #1084. October 14, 2013
Octocat-spinner-32 jquery.flot.canvas.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.categories.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.crosshair.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.errorbars.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.fillbetween.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.image.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.navigate.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.pie.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.resize.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.selection.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.stack.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.symbol.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.threshold.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.flot.time.js Update copyright year to 2014. April 16, 2014
Octocat-spinner-32 jquery.js Updated the bundled jQuery to version 1.8.3. November 22, 2012
Octocat-spinner-32 package.json Updated version number to 0.8.3-alpha. December 21, 2013
README.md

Flot Build status

About

Flot is a Javascript plotting library for jQuery.
Read more at the website: http://www.flotcharts.org/

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 browsers that support the HTML5 canvas tag are supported.

For support for Internet Explorer < 9, you can use Excanvas, a canvas emulator; this is used in the examples bundled with Flot. You just include the excanvas script like this:

<!--[if lte IE 8]><script language="javascript" type="text/javascript" src="excanvas.min.js"></script><![endif]-->

If it's not working on your development IE 6.0, check that it has support for VML which Excanvas is relying on. It appears that some stripped down versions used for test environments on virtual machines lack the VML support.

You can also try using Flashcanvas, which uses Flash to do the emulation. Although Flash can be a bit slower to load than VML, if you've got a lot of points, the Flash version can be much faster overall. Flot contains some wrapper code for activating Excanvas which Flashcanvas is compatible with.

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:

<div id="placeholder"></div>

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:

<div id="placeholder" style="width:600px;height:300px"></div>

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:

$.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):

$.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.

What's with the name?

First: it's pronounced with a short o, like "plot". Not like "flawed".

So "Flot" rhymes with "plot".

And if you look up "flot" in a Danish-to-English dictionary, some of the words that come up are "good-looking", "attractive", "stylish", "smart", "impressive", "extravagant". One of the main goals with Flot is pretty looks.

Notes about the examples

In order to have a useful, functional example of time-series plots using time zones, date.js from timezone-js (released under the Apache 2.0 license) and the Olson time zone database (released to the public domain) have been included in the examples directory. They are used in examples/axes-time-zones/index.html.

Something went wrong with that request. Please try again.