Flot Changelog

What's new in Flot 0.7

Jul 31, 2012
  • Support for specifying a bottom for each point for line charts when filling them, this means that an arbitrary bottom can be used instead of just the x axis (based on patches patiently provided by Roman V. Prikhodchenko).
  • New fillbetween plugin that can compute a bottom for a series from another series, useful for filling areas between lines (see new example percentiles.html for a use case).
  • More predictable handling of gaps for the stacking plugin, now all undefined ranges are skipped.
  • Stacking plugin can stack horizontal bar charts.
  • Navigate plugin now redraws the plot while panning instead of only after the fact (can be disabled by setting the pan.frameRate option to null), raised by lastthemy (issue 235).
  • Date formatter now accepts %0m and to get a zero-padded month or day (issue raised by Maximillian Dornseif).
  • Revamped internals to support an unlimited number of axes, not just dual (sponsored by Flight Data Services, www.flightdataservices.com).
  • New setting on axes, "tickLength", to control the size of ticks or turn them off without turning off the labels.
  • Axis labels are now put in container divs with classes, for instance labels in the x axes can be reached via ".xAxis .tickLabel".
  • Support for setting the color of an axis (sponsored by Flight Data Services, www.flightdataservices.com).
  • Tick color is now auto-generated as the base color with some transparency (unless you override it).
  • Support for aligning ticks in the axes with "alignTicksWithAxis" to ensure that they appear next to each other rather than in between, at the expense of possibly awkward tick steps (sponsored by Flight Data Services, www.flightdataservices.com).
  • Support for customizing the point type through a callback when plotting points and new symbol plugin with some predefined point types (sponsored by Utility Data Corporation).
  • Resize plugin for automatically redrawing when the placeholder changes size, e.g. on window resizes (sponsored by Novus Partners). A resize() method has been added to plot object facilitate this. Support Infinity/-Infinity for plotting asymptotes by hacking it into +/-Number.MAX_VALUE (reported by rabaea.mircea).
  • Support for restricting navigate plugin to not pan/zoom an axis (based on patch by kkaefer).
  • Support for providing the drag cursor for the navigate plugin as an option (based on patch by Kelly T. Moore).
  • Options for controlling whether an axis is shown or not (suggestion by Timo Tuominen) and whether to reserve space for it even if it isn't shown.
  • New attribute $.plot.version with the Flot version as a string.
  • The version comment is now included in the minified jquery.flot.min.js.
  • New options.grid.minBorderMargin for adjusting the minimum margin provided around the border (based on patch by corani, issue 188).
  • Refactor replot behaviour so Flot tries to reuse the existing canvas, adding shutdown() methods to the plot (based on patch by Ryley Breiddal, issue 269). This prevents a memory leak in Chrome and hopefully makes replotting faster for those who are using $.plot instead of .setData()/.draw(). Also update jQuery to 1.5.1 to prevent IE leaks fixed in jQuery.
  • New real-time line chart example.
  • New hooks: drawSeries, shutdown
  • Bug fixes:
  • Fixed problem with findNearbyItem and bars on top of each other (reported by ragingchikn, issue 242).
  • Fixed problem with ticks and the border (based on patch from ultimatehustler69, issue 236).
  • Fixed problem with plugins adding options to the series objects.
  • Fixed a problem introduced in 0.6 with specifying a gradient with { brightness: x, opacity: y }.
  • Don't use $.browser.msie, check for getContext on the created canvas element instead and try to use excanvas if it's not found (fixes IE 9 compatibility).
  • highlight(s, index) was looking up the point in the original s.data instead of in the computed datapoints array, which breaks with plugins that modify the datapoints (such as the stacking plugin). Issue 316 reported by curlypaul924.
  • More robust handling of axis from data passed in from getData() (problem reported by Morgan).
  • Fixed problem with turning off bar outline (issue 253, fix by Jordi Castells).
  • Check the selection passed into setSelection in the selection plugin, to guard against errors when synchronizing plots (fix by Lau Bech Lauritzen).
  • Fix bug in crosshair code with mouseout resetting the crosshair even if it is locked (fix by Lau Bech Lauritzen and Banko Adam).
  • Fix bug with points plotting using line width from lines rather than points.
  • Fix bug with passing non-array 0 data (for plugins that don't expect arrays, patch by vpapp1).
  • Fix errors in JSON in examples so they work with jQuery 1.4.2 (fix reported by honestbleeps, issue 357).
  • Fix bug with tooltip in interacting.html, this makes the tooltip much smoother (fix by bdkahn). Fix related bug inside highlighting handler in Flot.
  • Use closure trick to make inline colorhelpers plugin respect jQuery.noConflict(true), renaming the global jQuery object (reported by Nick Stielau).
  • Listen for mouseleave events and fire a plothover event with empty item when it occurs to drop highlights when the mouse leaves the plot (reported by by outspirit).
  • Fix bug with using aboveData with a background (reported by amitayd).
  • Fix possible excanvas leak (report and suggested fix by tom9729).
  • Fix bug with backwards compatibility for shadowSize = 0 (report and suggested fix by aspinak).
  • Adapt examples to skip loading excanvas (fix by Ryley Breiddal).
  • Fix bug that prevent a simple f(x) = -x transform from working correctly (fix by Mike, issue 263).
  • Fix bug in restoring cursor in navigate plugin (reported by Matteo Gattanini, issue 395).
  • Fix bug in picking items when transform/inverseTransform is in use (reported by Ofri Raviv, and patches and analysis by Jan and Tom Paton, issue 334 and 467).
  • Fix problem with unaligned ticks and hover/click events caused by padding on the placeholder by hardcoding the placeholder padding to 0 (reported by adityadineshsaxena, Matt Sommer, Daniel Atos and some other people, issue 301).
  • Update colorhelpers plugin to avoid dying when trying to parse an invalid string (reported by cadavor, issue 483).

New in Flot 0.6 (Apr 6, 2010)

  • Added support for disabling interactivity for specific data series
  • Flot now calls $() on the placeholder and optional legend container passed in so you can specify DOM elements or CSS expressions to make it easier to use Flot with libraries like Prototype or Mootools or through raw JSON from Ajax responses.
  • A new "plotselecting" event is now emitted while the user is making a selection.
  • The "plothover" event is now emitted immediately instead of at most 10 times per second, you'll have to put in a setTimeout yourself if you're doing something really expensive on this event.
  • The built-in date formatter can now be accessed as $.plot.formatDate(...) (suggestion by Matt Manela) and even replaced.
  • Added "borderColor" option to the grid
  • Added support for gradient backgrounds for the grid, take a look at the "setting options" example
  • Gradient bars
  • Added a "plotunselected" event which is triggered when the selection is removed, see "selection" example (suggestion by Meda Ugo);
  • The option legend.margin can now specify horizontal and vertical margins independently
  • Data passed into Flot is now copied to a new canonical format to enable further processing before it hits the drawing routines. As a side-effect, this should make Flot more robust in the face of bad data (and fixes issue 112).
  • Step-wise charting: line charts have a new option "steps" that when set to true connects the points with horizontal/vertical steps nstead of diagonal lines.
  • The legend labelFormatter now passes the series in addition to just the label
  • Horizontal bars
  • Support for partial bars by specifying a third coordinate, i.e. they don't have to start from the axis. This can be used to make stacked bars.
  • New option to disable the (grid.show).
  • Added pointOffset method for converting a point in data space to an offset within the placeholder.
  • Plugin system: register an init method in the $.flot.plugins array to get started, see PLUGINS.txt for details on how to write plugins

New in Flot 0.5 (Feb 25, 2009)

  • Backwards API change summary: Timestamps are now in UTC. Also "selected" event -> becomes "plotselected" with new data, the parameters for setSelection are now different (but backwards compatibility hooks are in place), coloredAreas becomes markings with a new interface (but backwards compatibility hooks are in place).
  • Interactivity: added a new "plothover" event and this and the "plotclick" event now returns the closest data item (based on patch by /david, patch by Mark Byers for bar support). See the revamped "interacting with the data" example for some hints on what you can do.
  • Highlighting: you can now highlight points and datapoints are autohighlighted when you hover over them (if hovering is turned on).
  • Support for dual axis has been added (based on patch by someone who's annoyed and /david). For each data series you can specify which axes it belongs to, and there are two more axes, x2axis and y2axis, to customize. This affects the "selected" event which has been renamed to "plotselected" and spews out { xaxis: { from: -10, to: 20 } ... }, setSelection in which the parameters are on a new form (backwards compatible hooks are in place so old code shouldn't break) and markings (formerly coloredAreas).
  • Timestamps in time mode are now displayed according to UTC instead of the time zone of the visitor. This affects the way the timestamps should be input; you'll probably have to offset the timestamps according to your local time zone. It also affects any custom date handling code (which basically now should use the equivalent UTC date mehods, e.g. .setUTCMonth() instead of .setMonth().
  • Added support for specifying the size of tick labels (axis.labelWidth, axis.labelHeight). Useful for specifying a max label size to keep multiple plots aligned.
  • Markings, previously coloredAreas, are now specified as ranges on the axes, like { xaxis: { from: 0, to: 10 }}. Furthermore with markings you can now draw horizontal/vertical lines by setting from and to to the same coordinate (idea from line support patch by by Ryan Funduk).
  • The "fill" option can now be a number that specifies the opacity of the fill.
  • You can now specify a coordinate as null (like [2, null]) and Flot will take the other coordinate into account when scaling the axes (based on patch by joebno).
  • New option for bars "align". Set it to "center" to center the bars on the value they represent.
  • setSelection now takes a second parameter which you can use to prevent the method from firing the "plotselected" handler.
  • Using the "container" option in legend now overwrites the container element instead of just appending to it (fixes infinite legend bug, reported by several people, fix by Brad Dewey).
  • Fixed a bug in calculating spacing around the plot (reported by timothytoe). Fixed a bug in finding max values for all-negative data sets. Prevent the possibility of eternal looping in tick calculations. Fixed a bug when borderWidth is set to 0 (reported by Rob/sanchothefat). Fixed a bug with drawing bars extending below 0 (reported by James Hewitt, patch by Ryan Funduk). Fixed a bug with line widths of bars (reported by MikeM). Fixed a bug with 'nw' and 'sw' legend positions. Improved the handling of axis auto-scaling with bars. Fixed a bug with multi-line x-axis tick labels (reported by Luca Ciano). IE-fix help by Savage Zhang.