Файл: admin/skins/lib/flot/NEWS.txt
Строк: 1095
Flot 0.7
--------
API changes:
Multiple axes support. Code using dual
axes should be changed from
using x2axis/y2axis in the options to using an
array (although
backwards-compatibility hooks are in place). For
instance,
{
xaxis: { ... }, x2axis: { ... },
yaxis: { ... },
y2axis: { ... }
}
becomes
{
xaxes: [ { ... }, { ... } ],
yaxes: [ { ... }, { ... } ]
}
Note that if you're just using one axis,
continue to use the
xaxis/yaxis directly (it now sets the default settings
for the
arrays). Plugins touching the axes must be ported to take the
extra
axes into account, check the source to see some examples.
A related
change is that the visibility of axes is now auto-detected.
So if you were
relying on an axis to show up even without any data in
the chart, you now
need to set the axis "show" option
explicitly.
"tickColor" on the grid options is now deprecated in
favour of a
corresponding option on the axes, so { grid: { tickColor:
"#000" }}
becomes { xaxis: { tickColor: "#000"}, yaxis:
{ tickColor: "#000"} },
but if you just configure a base color
Flot will now autogenerate a
tick color by adding transparency.
Backwards-compatibility hooks are
in place.
Final note: now that IE 9 is
coming out with canvas support, you may
want to adapt the excanvas include
to skip loading it in IE 9 (the
examples have been adapted thanks to Ryley
Breiddal). An alternative
to excanvas using Flash has also surfaced, if
your graphs are slow in
IE, you may want to give it a spin:
http://code.google.com/p/flashcanvas/
Changes:
- 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 %0d 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).
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 a 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.