|
|
1 |
Flot 0.6 |
|
|
2 |
-------- |
|
|
3 |
|
|
|
4 |
API changes: |
|
|
5 |
|
|
|
6 |
1. Selection support has been moved to a plugin. Thus if you're |
|
|
7 |
passing selection: { mode: something }, you MUST include the file |
|
|
8 |
jquery.flot.selection.js after jquery.flot.js. This reduces the size |
|
|
9 |
of base Flot and makes it easier to customize the selection as well as |
|
|
10 |
improving code clarity. The change is based on patch from andershol. |
|
|
11 |
|
|
|
12 |
2. In the global options specified in the $.plot command, |
|
|
13 |
"lines", "points", "bars" and "shadowSize" have been moved to a |
|
|
14 |
sub-object called "series", i.e. |
|
|
15 |
|
|
|
16 |
$.plot(placeholder, data, { lines: { show: true }}) |
|
|
17 |
|
|
|
18 |
should be changed to |
|
|
19 |
|
|
|
20 |
$.plot(placeholder, data, { series: { lines: { show: true }}}) |
|
|
21 |
|
|
|
22 |
All future series-specific options will go into this sub-object to |
|
|
23 |
simplify plugin writing. Backward-compatibility code is in place, so |
|
|
24 |
old code should not break. |
|
|
25 |
|
|
|
26 |
3. "plothover" no longer provides the original data point, but instead |
|
|
27 |
a normalized one, since there may be no corresponding original point. |
|
|
28 |
|
|
|
29 |
4. Due to a bug in previous versions of jQuery, you now need at least |
|
|
30 |
jQuery 1.2.6. But if you can, try jQuery 1.3.2 as it got some |
|
|
31 |
improvements in event handling speed. |
|
|
32 |
|
|
|
33 |
|
|
|
34 |
Changes: |
|
|
35 |
|
|
|
36 |
- Added support for disabling interactivity for specific data series |
|
|
37 |
(request from Ronald Schouten and Steve Upton). |
|
|
38 |
|
|
|
39 |
- Flot now calls $() on the placeholder and optional legend container |
|
|
40 |
passed in so you can specify DOM elements or CSS expressions to make |
|
|
41 |
it easier to use Flot with libraries like Prototype or Mootools or |
|
|
42 |
through raw JSON from Ajax responses. |
|
|
43 |
|
|
|
44 |
- A new "plotselecting" event is now emitted while the user is making |
|
|
45 |
a selection. |
|
|
46 |
|
|
|
47 |
- The "plothover" event is now emitted immediately instead of at most |
|
|
48 |
10 times per second, you'll have to put in a setTimeout yourself if |
|
|
49 |
you're doing something really expensive on this event. |
|
|
50 |
|
|
|
51 |
- The built-in date formatter can now be accessed as |
|
|
52 |
$.plot.formatDate(...) (suggestion by Matt Manela) and even |
|
|
53 |
replaced. |
|
|
54 |
|
|
|
55 |
- Added "borderColor" option to the grid (patch from Amaury Chamayou |
|
|
56 |
and patch from Mike R. Williamson). |
|
|
57 |
|
|
|
58 |
- Added support for gradient backgrounds for the grid, take a look at |
|
|
59 |
the "setting options" example (based on patch from Amaury Chamayou, |
|
|
60 |
issue 90). |
|
|
61 |
|
|
|
62 |
- Gradient bars (suggestion by stefpet). |
|
|
63 |
|
|
|
64 |
- Added a "plotunselected" event which is triggered when the selection |
|
|
65 |
is removed, see "selection" example (suggestion by Meda Ugo); |
|
|
66 |
|
|
|
67 |
- The option legend.margin can now specify horizontal and vertical |
|
|
68 |
margins independently (suggestion by someone who's annoyed). |
|
|
69 |
|
|
|
70 |
- Data passed into Flot is now copied to a new canonical format to |
|
|
71 |
enable further processing before it hits the drawing routines. As a |
|
|
72 |
side-effect, this should make Flot more robust in the face of bad |
|
|
73 |
data (and fixes issue 112). |
|
|
74 |
|
|
|
75 |
- Step-wise charting: line charts have a new option "steps" that when |
|
|
76 |
set to true connects the points with horizontal/vertical steps |
|
|
77 |
instead of diagonal lines. |
|
|
78 |
|
|
|
79 |
- The legend labelFormatter now passes the series in addition to just |
|
|
80 |
the label (suggestion by Vincent Lemeltier). |
|
|
81 |
|
|
|
82 |
- Horizontal bars (based on patch by Jason LeBrun). |
|
|
83 |
|
|
|
84 |
- Support for partial bars by specifying a third coordinate, i.e. they |
|
|
85 |
don't have to start from the axis. This can be used to make stacked |
|
|
86 |
bars. |
|
|
87 |
|
|
|
88 |
- New option to disable the (grid.show). |
|
|
89 |
|
|
|
90 |
- Added pointOffset method for converting a point in data space to an |
|
|
91 |
offset within the placeholder. |
|
|
92 |
|
|
|
93 |
- Plugin system: register an init method in the $.flot.plugins array |
|
|
94 |
to get started, see PLUGINS.txt for details on how to write plugins |
|
|
95 |
(it's easy). There are also some extra methods to enable access to |
|
|
96 |
internal state. |
|
|
97 |
|
|
|
98 |
- Hooks: you can register functions that are called while Flot is |
|
|
99 |
crunching the data and doing the plot. This can be used to modify |
|
|
100 |
Flot without changing the source, useful for writing plugins. Some |
|
|
101 |
hooks are defined, more are likely to come. |
|
|
102 |
|
|
|
103 |
- Threshold plugin: you can set a threshold and a color, and the data |
|
|
104 |
points below that threshold will then get the color. Useful for |
|
|
105 |
marking data below 0, for instance. |
|
|
106 |
|
|
|
107 |
- Stack plugin: you can specify a stack key for each series to have |
|
|
108 |
them summed. This is useful for drawing additive/cumulative graphs |
|
|
109 |
with bars and (currently unfilled) lines. |
|
|
110 |
|
|
|
111 |
- Crosshairs plugin: trace the mouse position on the axes, enable with |
|
|
112 |
crosshair: { mode: "x"} (see the new tracking example for a use). |
|
|
113 |
|
|
|
114 |
- Image plugin: plot prerendered images. |
|
|
115 |
|
|
|
116 |
- Navigation plugin for panning and zooming a plot. |
|
|
117 |
|
|
|
118 |
- More configurable grid. |
|
|
119 |
|
|
|
120 |
- Axis transformation support, useful for non-linear plots, e.g. log |
|
|
121 |
axes and compressed time axes (like omitting weekends). |
|
|
122 |
|
|
|
123 |
- Support for twelve-hour date formatting (patch by Forrest Aldridge). |
|
|
124 |
|
|
|
125 |
- The color parsing code in Flot has been cleaned up and split out so |
|
|
126 |
it's now available as a separate jQuery plugin. It's included inline |
|
|
127 |
in the Flot source to make dependency managing easier. This also |
|
|
128 |
makes it really easy to use the color helpers in Flot plugins. |
|
|
129 |
|
|
|
130 |
Bug fixes: |
|
|
131 |
|
|
|
132 |
- Fixed two corner-case bugs when drawing filled curves (report and |
|
|
133 |
analysis by Joshua Varner). |
|
|
134 |
- Fix auto-adjustment code when setting min to 0 for an axis where the |
|
|
135 |
dataset is completely flat on that axis (report by chovy). |
|
|
136 |
- Fixed a bug with passing in data from getData to setData when the |
|
|
137 |
secondary axes are used (issue 65, reported by nperelman). |
|
|
138 |
- Fixed so that it is possible to turn lines off when no other chart |
|
|
139 |
type is shown (based on problem reported by Glenn Vanderburg), and |
|
|
140 |
fixed so that setting lineWidth to 0 also hides the shadow (based on |
|
|
141 |
problem reported by Sergio Nunes). |
|
|
142 |
- Updated mousemove position expression to the latest from jQuery (bug |
|
|
143 |
reported by meyuchas). |
|
|
144 |
- Use CSS borders instead of background in legend (fix printing issue 25 |
|
|
145 |
and 45). |
|
|
146 |
- Explicitly convert axis min/max to numbers. |
|
|
147 |
- Fixed a bug with drawing marking lines with different colors |
|
|
148 |
(reported by Khurram). |
|
|
149 |
- Fixed a bug with returning y2 values in the selection event (fix |
|
|
150 |
by exists, issue 75). |
|
|
151 |
- Only set position relative on placeholder if it hasn't already a |
|
|
152 |
position different from static (reported by kyberneticist, issue 95). |
|
|
153 |
- Don't round markings to prevent sub-pixel problems (reported by Dan |
|
|
154 |
Lipsitt). |
|
|
155 |
- Make the grid border act similarly to a regular CSS border, i.e. |
|
|
156 |
prevent it from overlapping the plot itself. This also fixes a |
|
|
157 |
problem with anti-aliasing when the width is 1 pixel (reported by |
|
|
158 |
Anthony Ettinger). |
|
|
159 |
- Imported version 3 of excanvas and fixed two issues with the newer |
|
|
160 |
version. Hopefully, this will make Flot work with IE8 (nudge by |
|
|
161 |
Fabien Menager, further analysis by Booink, issue 133). |
|
|
162 |
- Changed the shadow code for lines to hopefully look a bit better |
|
|
163 |
with vertical lines. |
|
|
164 |
- Round tick positions to avoid possible problems with fractions |
|
|
165 |
(suggestion by Fred, issue 130). |
|
|
166 |
- Made the heuristic for determining how many ticks to aim for a bit |
|
|
167 |
smarter. |
|
|
168 |
- Fix for uneven axis margins (report and patch by Paul Kienzle) and |
|
|
169 |
snapping to ticks (concurrent report and patch by lifthrasiir). |
|
|
170 |
- Fixed bug with slicing in findNearbyItems (patch by zollman). |
|
|
171 |
- Make heuristic for x axis label widths more dynamic (patch by |
|
|
172 |
rickinhethuis). |
|
|
173 |
- Make sure points on top take precedence when finding nearby points |
|
|
174 |
when hovering (reported by didroe, issue 224). |
|
|
175 |
|
|
|
176 |
Flot 0.5 |
|
|
177 |
-------- |
|
|
178 |
|
|
|
179 |
Backwards API change summary: Timestamps are now in UTC. Also |
|
|
180 |
"selected" event -> becomes "plotselected" with new data, the |
|
|
181 |
parameters for setSelection are now different (but backwards |
|
|
182 |
compatibility hooks are in place), coloredAreas becomes markings with |
|
|
183 |
a new interface (but backwards compatibility hooks are in place). |
|
|
184 |
|
|
|
185 |
|
|
|
186 |
Interactivity: added a new "plothover" event and this and the |
|
|
187 |
"plotclick" event now returns the closest data item (based on patch by |
|
|
188 |
/david, patch by Mark Byers for bar support). See the revamped |
|
|
189 |
"interacting with the data" example for some hints on what you can do. |
|
|
190 |
|
|
|
191 |
Highlighting: you can now highlight points and datapoints are |
|
|
192 |
autohighlighted when you hover over them (if hovering is turned on). |
|
|
193 |
|
|
|
194 |
Support for dual axis has been added (based on patch by someone who's |
|
|
195 |
annoyed and /david). For each data series you can specify which axes |
|
|
196 |
it belongs to, and there are two more axes, x2axis and y2axis, to |
|
|
197 |
customize. This affects the "selected" event which has been renamed to |
|
|
198 |
"plotselected" and spews out { xaxis: { from: -10, to: 20 } ... }, |
|
|
199 |
setSelection in which the parameters are on a new form (backwards |
|
|
200 |
compatible hooks are in place so old code shouldn't break) and |
|
|
201 |
markings (formerly coloredAreas). |
|
|
202 |
|
|
|
203 |
Timestamps in time mode are now displayed according to |
|
|
204 |
UTC instead of the time zone of the visitor. This affects the way the |
|
|
205 |
timestamps should be input; you'll probably have to offset the |
|
|
206 |
timestamps according to your local time zone. It also affects any |
|
|
207 |
custom date handling code (which basically now should use the |
|
|
208 |
equivalent UTC date mehods, e.g. .setUTCMonth() instead of |
|
|
209 |
.setMonth(). |
|
|
210 |
|
|
|
211 |
Added support for specifying the size of tick labels (axis.labelWidth, |
|
|
212 |
axis.labelHeight). Useful for specifying a max label size to keep |
|
|
213 |
multiple plots aligned. |
|
|
214 |
|
|
|
215 |
Markings, previously coloredAreas, are now specified as ranges on the |
|
|
216 |
axes, like { xaxis: { from: 0, to: 10 }}. Furthermore with markings |
|
|
217 |
you can now draw horizontal/vertical lines by setting from and to to |
|
|
218 |
the same coordinate (idea from line support patch by by Ryan Funduk). |
|
|
219 |
|
|
|
220 |
The "fill" option can now be a number that specifies the opacity of |
|
|
221 |
the fill. |
|
|
222 |
|
|
|
223 |
You can now specify a coordinate as null (like [2, null]) and Flot |
|
|
224 |
will take the other coordinate into account when scaling the axes |
|
|
|