123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340 |
- Flot 0.6
- --------
-
- API changes:
-
- 1. Selection support has been moved to a plugin. Thus if you're
- passing selection: { mode: something }, you MUST include the file
- jquery.flot.selection.js after jquery.flot.js. This reduces the size
- of base Flot and makes it easier to customize the selection as well as
- improving code clarity. The change is based on patch from andershol.
-
- 2. In the global options specified in the $.plot command,
- "lines", "points", "bars" and "shadowSize" have been moved to a
- sub-object called "series", i.e.
-
- $.plot(placeholder, data, { lines: { show: true }})
-
- should be changed to
-
- $.plot(placeholder, data, { series: { lines: { show: true }}})
-
- All future series-specific options will go into this sub-object to
- simplify plugin writing. Backward-compatibility code is in place, so
- old code should not break.
-
- 3. "plothover" no longer provides the original data point, but instead
- a normalized one, since there may be no corresponding original point.
-
- 4. Due to a bug in previous versions of jQuery, you now need at least
- jQuery 1.2.6. But if you can, try jQuery 1.3.2 as it got some
- improvements in event handling speed.
-
-
- Changes:
-
- - Added support for disabling interactivity for specific data series
- (request from Ronald Schouten and Steve Upton).
-
- - 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 (patch from Amaury Chamayou
- and patch from Mike R. Williamson).
-
- - Added support for gradient backgrounds for the grid, take a look at
- the "setting options" example (based on patch from Amaury Chamayou,
- issue 90).
-
- - Gradient bars (suggestion by stefpet).
-
- - 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 (suggestion by someone who's annoyed).
-
- - 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
- instead of diagonal lines.
-
- - The legend labelFormatter now passes the series in addition to just
- the label (suggestion by Vincent Lemeltier).
-
- - Horizontal bars (based on patch by Jason LeBrun).
-
- - 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
- (it's easy). There are also some extra methods to enable access to
- internal state.
-
- - Hooks: you can register functions that are called while Flot is
- crunching the data and doing the plot. This can be used to modify
- Flot without changing the source, useful for writing plugins. Some
- hooks are defined, more are likely to come.
-
- - Threshold plugin: you can set a threshold and a color, and the data
- points below that threshold will then get the color. Useful for
- marking data below 0, for instance.
-
- - Stack plugin: you can specify a stack key for each series to have
- them summed. This is useful for drawing additive/cumulative graphs
- with bars and (currently unfilled) lines.
-
- - Crosshairs plugin: trace the mouse position on the axes, enable with
- crosshair: { mode: "x"} (see the new tracking example for a use).
-
- - Image plugin: plot prerendered images.
-
- - Navigation plugin for panning and zooming a plot.
-
- - More configurable grid.
-
- - Axis transformation support, useful for non-linear plots, e.g. log
- axes and compressed time axes (like omitting weekends).
-
- - Support for twelve-hour date formatting (patch by Forrest Aldridge).
-
- - The color parsing code in Flot has been cleaned up and split out so
- it's now available as a separate jQuery plugin. It's included inline
- in the Flot source to make dependency managing easier. This also
- makes it really easy to use the color helpers in Flot plugins.
-
- Bug fixes:
-
- - Fixed two corner-case bugs when drawing filled curves (report and
- analysis by Joshua Varner).
- - Fix auto-adjustment code when setting min to 0 for an axis where the
- dataset is completely flat on that axis (report by chovy).
- - Fixed a bug with passing in data from getData to setData when the
- secondary axes are used (issue 65, reported by nperelman).
- - Fixed so that it is possible to turn lines off when no other chart
- type is shown (based on problem reported by Glenn Vanderburg), and
- fixed so that setting lineWidth to 0 also hides the shadow (based on
- problem reported by Sergio Nunes).
- - Updated mousemove position expression to the latest from jQuery (bug
- reported by meyuchas).
- - Use CSS borders instead of background in legend (fix printing issue 25
- and 45).
- - Explicitly convert axis min/max to numbers.
- - Fixed a bug with drawing marking lines with different colors
- (reported by Khurram).
- - Fixed a bug with returning y2 values in the selection event (fix
- by exists, issue 75).
- - Only set position relative on placeholder if it hasn't already a
- position different from static (reported by kyberneticist, issue 95).
- - Don't round markings to prevent sub-pixel problems (reported by Dan
- Lipsitt).
- - Make the grid border act similarly to a regular CSS border, i.e.
- prevent it from overlapping the plot itself. This also fixes a
- problem with anti-aliasing when the width is 1 pixel (reported by
- Anthony Ettinger).
- - Imported version 3 of excanvas and fixed two issues with the newer
- version. Hopefully, this will make Flot work with IE8 (nudge by
- Fabien Menager, further analysis by Booink, issue 133).
- - Changed the shadow code for lines to hopefully look a bit better
- with vertical lines.
- - Round tick positions to avoid possible problems with fractions
- (suggestion by Fred, issue 130).
- - Made the heuristic for determining how many ticks to aim for a bit
- smarter.
- - Fix for uneven axis margins (report and patch by Paul Kienzle) and
- snapping to ticks (concurrent report and patch by lifthrasiir).
- - Fixed bug with slicing in findNearbyItems (patch by zollman).
- - Make heuristic for x axis label widths more dynamic (patch by
- rickinhethuis).
- - Make sure points on top take precedence when finding nearby points
- when hovering (reported by didroe, issue 224).
-
- Flot 0.5
- --------
-
- 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.
-
-
- Flot 0.4
- --------
-
- API changes: deprecated axis.noTicks in favor of just specifying the
- number as axis.ticks. So "xaxis: { noTicks: 10 }" becomes
- "xaxis: { ticks: 10 }"
-
- Time series support. Specify axis.mode: "time", put in Javascript
- timestamps as data, and Flot will automatically spit out sensible
- ticks. Take a look at the two new examples. The format can be
- customized with axis.timeformat and axis.monthNames, or if that fails
- with axis.tickFormatter.
-
- Support for colored background areas via grid.coloredAreas. Specify an
- array of { x1, y1, x2, y2 } objects or a function that returns these
- given { xmin, xmax, ymin, ymax }.
-
- More members on the plot object (report by Chris Davies and others).
- "getData" for inspecting the assigned settings on data series (e.g.
- color) and "setData", "setupGrid" and "draw" for updating the contents
- without a total replot.
-
- The default number of ticks to aim for is now dependent on the size of
- the plot in pixels. Support for customizing tick interval sizes
- directly with axis.minTickSize and axis.tickSize.
-
- Cleaned up the automatic axis scaling algorithm and fixed how it
- interacts with ticks. Also fixed a couple of tick-related corner case
- bugs (one reported by mainstreetmark, another reported by timothytoe).
-
- The option axis.tickFormatter now takes a function with two
- parameters, the second parameter is an optional object with
- information about the axis. It has min, max, tickDecimals, tickSize.
-
- Added support for segmented lines (based on patch from Michael
- MacDonald) and for ignoring null and bad values (suggestion from Nick
- Konidaris and joshwaihi).
-
- Added support for changing the border width (joebno and safoo).
- Label colors can be changed via CSS by selecting the tickLabel class.
-
- Fixed a bug in handling single-item bar series (reported by Emil
- Filipov). Fixed erratic behaviour when interacting with the plot
- with IE 7 (reported by Lau Bech Lauritzen). Prevent IE/Safari text
- selection when selecting stuff on the canvas.
-
-
-
- Flot 0.3
- --------
-
- This is mostly a quick-fix release because jquery.js wasn't included
- in the previous zip/tarball.
-
- Support clicking on the plot. Turn it on with grid: { clickable: true },
- then you get a "plotclick" event on the graph placeholder with the
- position in units of the plot.
-
- Fixed a bug in dealing with data where min = max, thanks to Michael
- Messinides.
-
- Include jquery.js in the zip/tarball.
-
-
- Flot 0.2
- --------
-
- Added support for putting a background behind the default legend. The
- default is the partly transparent background color. Added
- backgroundColor and backgroundOpacity to the legend options to control
- this.
-
- The ticks options can now be a callback function that takes one
- parameter, an object with the attributes min and max. The function
- should return a ticks array.
-
- Added labelFormatter option in legend, useful for turning the legend
- labels into links.
-
- Fixed a couple of bugs.
-
- The API should now be fully documented.
-
- Patch from Guy Fraser to make parts of the code smaller.
-
- API changes: Moved labelMargin option to grid from x/yaxis.
-
-
- Flot 0.1
- --------
-
- First public release.
|