UNPKG

56.4 kBMarkdownView Raw
1# Changelog
2All notable changes to this project will be documented in this file.
3
4## [3.2.0]
5
6### Changes ###
7
8- Removed CORS stylesheet support
9- Added the category plugin back into the distribution
10- [Changed how bar width is computed.](https://github.com/flot/flot/pull/1663) - We now will filter unique x-values and then sort them before computing bar width.
11
12### Bug Fixes ###
13
14- [Issue 1645](https://github.com/flot/flot/issues/1645) (change [1656](https://github.com/flot/flot/pull/1656)) - Refactoring hover plugin so events get registered in proper order.
15- [Issue 1642](https://github.com/flot/flot/issues/1642) (change [1657](https://github.com/flot/flot/pull/1657)) - Remove a canvas resizing implementation that doesn't support scaling.
16- [Issue 1638](https://github.com/flot/flot/issues/1638) (change [1660](https://github.com/flot/flot/pull/1660)) - Fix overloading of date types to allow using methods like 'setFullYear()'
17- [Issue 1664](https://github.com/flot/flot/issues/1664) (change [1665](https://github.com/flot/flot/pull/1665)) - Fix issue with fill when data has null values.
18
19## [3.1.0]
20
21### Changes ###
22
23- We now are triggering a second onDrawingDone event on the placeholder object (in addition to the eventholder).
24- Added support for loading stylesheets in cross origin scenarios (this has since been removed as this was deemed a bit of a hack and can still be accomplished by the user of flot through other means).
25
26## [3.0.0]
27
28### Breaking Change ###
29
30- Setting 'pan: {enableTouch: true}' in the options will no longer automatically turn on pinch gestures for touch support. You must set 'zoom: {enableTouch: true}' in the options to enable pinch support (which was always a zoom operation).
31
32## [2.2.0]
33
34### Changes ###
35
36- Added new pan modes for mouse and touch interactions.
37
38### Bug fixes ###
39
40- Fixed issue with empty string tick label being replaced by auto-generated label.
41- Fixed issue with hovering over bars no longer working.
42- Fixed tracking example to update legend again.
43- Fixed issue with tooltips not being correct for stacked graphs.
44
45## [2.0.1]
46
47## Notable Breaking Changes For Existing flot Users
48### Series Options:
49Before:
50
51 var plot = $.plot(placeholder, data, {
52 bars: { show: true, barWidth: 0.5, fill: 0.9 },
53 xaxis: { ticks: [], autoscaleMargin: 0.02 },
54 yaxis: { min: -2, max: 2 },
55 grid: { markings: markings }
56 });
57
58After:
59
60 var plot = $.plot(placeholder, data, {
61 series: {
62 bars: { show: true, barWidth: 0.5, fill: 0.9 }
63 },
64 xaxis: { show: false },
65 yaxis: { min: -2, max: 2, autoScale: "none" },
66 grid: { markings: markings }
67 });
68
69Note: Backwards compatibility was removed such that we require series options to be encapsulated.
70
71### Time Formatting:
72Before:
73
74 $.plot("#placeholder", [d], {
75 xaxis: {
76 mode: "time",
77 minTickSize: [1, "year"],
78 min: (new Date(1996, 0, 1)).getTime(),
79 max: (new Date(2000, 0, 1)).getTime()
80 }
81 });
82
83After:
84
85 $.plot("#placeholder", [d], {
86 xaxis: {
87 mode: "time",
88 minTickSize: [1, "year"],
89 autoScale: "none",
90 min: (new Date(1996, 0, 1)).getTime(),
91 max: (new Date(2000, 0, 1)).getTime(),
92 timeBase: "milliseconds"
93 }
94 });
95
96Note: A new capability allows for data (and min/max settings of axes) to be specified with a `timeBase` of either seconds or milliseconds. So, a range from 1-10 can either represent 9 milliseconds of data, or 9 seconds of data, depending on the setting of `timeBase` (whose default is "seconds").
97
98### Script Locations:
99
100All scripts have been moved under the 'source' folder, so you will need to update all reference scripts to point to new location. Or you can use the file dist/es5/jquery.flot.js which is all source combined and minified.
101
102### SVG rendering:
103
104We now render axes and the legend through SVG. Any CSS targeting specific DOM objects related to these will now be broken.
105
106## New Features:
107
108### Auto-scaling options (`autoScale` property of axes)
109- Allows for various ways to auto-scale the axes in response to plotting new data (see API.md).
110- The public method `setupGrid` now takes a boolean argument to indicate whether or not to perform an autoScale according to the current setting on the axes.
111
112### Tick Label visibility options
113- Allows a user to specify whether to show tick labels on all major ticks, at endpoints only, all (major ticks and endpoints), or none at all.
114
115### Axis inversion
116- An axis now be inverted (swap min/max positions) through the `inverted` option on the axes.
117
118### Axis grid lines
119- Grid lines can now be turned off or on for individual axes.
120
121### Axis `boxPosition`
122- Allows a user to specify the position an axis is rendered within its box.
123
124### New `barWidth` options
125
126- Allows for the number supplied as the width to be treated either as a relative value related to the minimum distance between consecutive points, or as an absolute value in terms of units on the axis.
127
128### New logaxis plugin!
129- Example is provided
130
131### Touch navigation!
132- Use the touchNavigate plugin to access touch panning gestures
133
134## Numerous bug fixes
135
136## [1.1.5]
137
138### Bug fixes ###
139interpolation should not occur outside the provided data
140
141## [1.1.4]
142
143### Changes ###
144- making graph screen capture work for Safari
145
146## [1.1.3]
147
148### Changes ###
149- document flot plugins
150- refactor default tick generators and formatters and logaxis
151
152### Bug fixes ###
153- Fixed some browser detection functions, which depend on other similar functions
154
155## [1.1.2]
156
157### Changes ###
158- move backgroundColor and backgroundOpacity from legend settings to css
159
160## [1.1.0]
161
162### Changes ###
163- getPixelRatio moved from the plot instance to $.plot.browser namespace
164- Added 'onDrawingDone' custom event, dispatched by triggerRedrawOverlay.
165
166### Bug fixes ###
167- Pinch events fired too fast and slowing down the drawing
168
169## [1.0.10]
170
171### Bug fixes ###
172- Skipping the first point when looking for the nearest point
173- Wrong coordinates when tapping a point
174
175## [1.0.9]
176
177### Bug fixes ###
178- Panning the plot in Firefox using any mouse button
179- Overlay canvas cleared too often
180- Click or mouse wheel pressed while dragging will stop drag event
181
182## [1.0.8]
183
184### Bug fixes ###
185- tspan leak for absolute time axis fix
186- Fix snapshot image size for pixel ratios less than 1
187
188## [1.0.7]
189### Changes ###
190- Generate plothover event for tap on point
191- Support for mobile safari browser for snapshots
192
193### Bug fixes ###
194- Fix legend background color
195
196## [1.0.6]
197### Bug fixes ###
198- Hang caused by 'use' elements in SVGs when calling composeImages
199
200## [1.0.5]
201### Changes ###
202- Activate graph navigation on double click
203
204### Bug fixes ###
205- Wrong tick labels position
206
207## [1.0.4]
208### Changes ###
209- New getPixelRatio() helper function
210
211### Bug fixes ###
212- Multi lines labels
213
214
215## [1.0.3]
216### Changes ###
217
218- Change jquery.flot.legend.js to use SVG and add it to the distribution
219
220### Bug fixes ###
221
222- No minimum margin for axis tick labels
223- Fixed pixel ratio for devices with a different pixel ratio than 1,
224for creating graph snapshots
225
226
227## [1.0.2]
228### Changes ###
229
230- Expose the composeImages as part of the plot instance
231
232### Bug fixes ###
233
234- The speed of the zoom made on the Mac track pad
235- Invalid SVG width and height values red by composeImages on Firefox
236
237
238## [1.0.1]
239### Changes ###
240
241- Added jquery.flot.composeImages.js to distribution
242
243
244## [1.0.0]
245
246### Changes ###
247
248- single file distribution: dist/es5/jquery.flot.js
249- Edge and Safari support
250- PhantomJS and IE are no longer supported
251- the axis and tick labels are now rendered using SVG text and g nodes instead of div
252- autoscale option from axis API renamed autoScale
253- autoscaleMargin option for scale loose renamed autoScaleMargin
254- changelog NEWS.md renamed to CHANGELOG.md
255
256## engineering-flot 0.6.0 ##
257
258### Changes ###
259
260- change API by adding function to interpolate the position between nearest neighbors on OY axis
261
262## engineering-flot 0.5.7 ##
263
264### Changes ###
265
266- three fingers pinch affects browser zoom
267- consider axisZoom and plotZoom flags for enabling axis zooming, axisPan and plotPan for panning
268
269### Bug fixes ###
270
271- touch pan for axis, zoom plot and zoom axis
272
273## engineering-flot 0.5.6 ##
274
275### Bug fixes ###
276
277- touch pan plot
278- call points decimation from webcharts before drawing series points
279
280## engineering-flot 0.5.5 ##
281
282### Changes ###
283
284- order of default plot color
285
286### Bug fixes ###
287
288- plot margins and axis position should be adjusted based on user's grid margin options
289
290## engineering-flot 0.5.4 ##
291
292### Bug fixes ###
293
294- axis for bar plot with no data
295
296## engineering-flot 0.5.3 ##
297
298### Bug fixes ###
299
300- panning log axes on x and y in the same time.
301- endpoint tick labels for bars.
302
303## engineering-flot 0.5.2 ##
304
305### Bug fixes ###
306
307- zoom out instead of zoom in after excesive scroll.
308- loosing precition when panning on x and y in the same time.
309- navigation close to 0 for log axis.
310
311## engineering-flot 0.5.1 ##
312
313### Bug fixes ###
314
315- patching the pan jquery plugin to work with any jquery version.
316
317## engineering-flot 0.5.0 ##
318
319### Changes ###
320
321- the pan and mouse wheel jquery plugin were moved in their own files.
322
323## engineering-flot 0.4.15 ##
324
325### Bug fixes ###
326
327- bars width.
328
329## engineering-flot 0.4.14 ##
330
331### Bug fixes ###
332
333- long tap.
334- mouse pan.
335- improved precision used by the tick formatter.
336
337## engineering-flot 0.4.10 ##
338
339### Changes ###
340
341- basic touch support.
342
343### Bug fixes ###
344
345- include absRelTime file in the package.
346- fix for relative time.
347
348## engineering-flot 0.4.8 ##
349
350### Changes ###
351
352- bar width is computed based on the distance between points.
353- relative time axis.
354
355### Bug fixes ###
356
357- any axis regardless its visibility has a tick formatter.
358
359## engineering-flot 0.4.7 ##
360
361### Changes ###
362
363- fillTowards for bars.
364- removing vertical bars.
365- log axis improvements.
366
367## engineering-flot 0.4.6 ##
368
369### Changes ###
370
371- scatter graph performance improvements.
372
373## engineering-flot 0.4.5 ##
374
375### Changes ###
376
377- ability to reserve space to the left or right of the axis.
378
379### Bug fixes ###
380
381- wrong buffer size when writing smaller data.
382
383## engineering-flot 0.4.4 ##
384
385### Changes ###
386
387- zooming only the hovered axis.
388
389## engineering-flot 0.4.2 ##
390
391### Bug fixes ###
392
393- memory leak caused by axis tick labels.
394
395## engineering-flot 0.4.1 ##
396
397### Changes ###
398
399- ability to find the nearby item with a custom function.
400
401### Bug fixes ###
402
403- memory leak caused by axis labels.
404
405## engineering-flot 0.4.0 ##
406
407### Changes ###
408
409- sliding-window mode for auto scale.
410- small navigation improvements.
411
412### Bug fixes ###
413
414- precision of tick labels for large numbers.
415
416## engineering-flot 0.3.8 ##
417
418### Changes ###
419
420- log axis now allow a custom formatter to be specified.
421
422## engineering-flot 0.3.5 ##
423
424### Changes ###
425
426- add linter
427
428### Bug fixes ###
429
430- fixes the computation of precission needed for the endpoint tick labels.
431
432## engineering-flot 0.3.4 ##
433
434### Bug fixes ###
435
436- axis formatter fixes.
437
438## engineering-flot 0.3.2 ##
439
440### Bug fixes ###
441
442- fix pan and zoom to work for all autoscale modes.
443
444## engineering-flot 0.3.1 ##
445
446### Changes ###
447
448- engineering-flot should be consumed by loading the newly added dist/jquery.flot.js
449file and the needed plugins.
450- display the endpoint ticks with better precission.
451
452## engineering-flot 0.2.4 ##
453
454### Changes ###
455
456- Axis range is between axis.min and axis.max if no data available
457
458## engineering-flot 0.2.3 ##
459
460### Changes ###
461
462- add computeRangeForDataSeries and adjustSeriesDataRange methods to the plot
463- add adjustSeriesDataRange hook.
464
465## engineering-flot 0.2.2 ##
466
467### Changes ###
468
469- add new symbols to the symbols plugin
470- Fix for autoScale=loose and stop generating endpoints when not needed
471- make axilabels plugin strict
472- use karma to run the (few) tests we have
473- run the tests on TravisCI
474- add coveralls support
475
476## engineering-flot 0.2.1 ##
477
478### Changes ###
479
480- the axis autoscale option was a breaking change, increment the minor version
481(late is better that never) and fix the examples.
482
483## engineering-flot 0.1.15 ##
484
485### Changes ###
486
487- add the findNearbyItem method to the plot.
488- add an axis autoscale option that is used to specify the desired autoscale mode.
489
490## engineering-flot 0.1.14 ##
491
492### Changes ###
493
494- Performance: make the axislabels use the axisReserveSpace hook which results in
495simpler, faster code for axis labels.
496
497## engineering-flot 0.1.12 ##
498
499### Bug fixes ###
500
501- fixes for showTickLabels option introduced in 0.1.11
502
503## engineering-flot 0.1.11 ##
504
505### Changes ###
506
507- add showTickLabels option that can be used to specify which ticks labels are visible:
508 +"none", "endpoints", "major" or "all". The default is "major".
509
510- add fillTowards option, used to specify the baseline for area and bar fills. The
511most usefull ones are 0 ,-Infiniy and +Infinity.
512
513## engineering-flot 0.1.10 ##
514
515### Changes ###
516
517- add the ability to disable pan for a specific axis
518
519## engineering-flot 0.1.9 ##
520
521### Changes ###
522
523Cosmetic: improve the way the navigation hints are drawn. Add ellipse to the
524flot.symbols plugin.
525
526## engineering-flot 0.1.8 ##
527
528### Changes ###
529
530- Don't compute datamin and datamax if not autoscaling, this improves the performance in some cases.
531
532## engineering-flot 0.1.7 ##
533
534### Changes ###
535
536- implement grow-only autoscaling behaviour and add docs and example
537
538## engineering-flot 0.1.6 ##
539
540### Bug fixes ###
541
542- make the text measurements cache more robust, cache the measurements for ticks
543that were measured but not displayed too. This improves the performance a bit.
544
545## engineering-flot 0.1.5 ##
546
547### Changes ###
548
549- Add tickmarks functionality. Tick marks support the following cases:
550
551 - Major Ticks Marks visible (showTicks : true, showMinorTicks : false)
552 - Major & Minor Ticks Marks visible (showTicks : true, showMinorTicks : true)
553 - All Tick Marks hidden (showTicks : false)
554
555## engineering-flot 0.1.4 ##
556
557### Changes ###
558
559- fix examples
560
561## engineering-flot 0.1.3 ##
562
563### Changes ###
564
565import the Axis Labels Plugin from http://github.com/markrcote/flot-axislabels
566
567## engineering-flot 0.1.2 ##
568
569### Changes ###
570
571- add clearCache function that clears the measurements cache.
572
573## engineering-flot 0.1.1 ##
574
575### Changes ###
576
577- Forked the Flot codebase into engineering flot
578
579- add logaxis plugin
580- add smart pan to the navigation plugin
581- remove code for backwards compatibility
582- remove excanvas support
583- split Canvas wrapper into a separate file
584- test infrastructure
585- improve the performance by:
586 - add a flatdata plugin that enables passing data into a faster and memory
587 efficient format
588 - allow the use of a user specified decimation method
589 - reuse internal buffers if possible.
590
591- add an svg layer to Flot
592
593
594
595## Flot 0.8.3 ##
596
597### Changes ###
598
599- Updated example code to avoid encouraging unnecessary re-plots.
600 (patch by soenter, pull request #1221)
601
602### Bug fixes ###
603
604 - Added a work-around to disable the allocation of extra space for first and
605 last axis ticks, allowing plots to span the full width of their container.
606 A proper solution for this bug will be implemented in the 0.9 release.
607 (reported by Josh Pigford and andig, issue #1212, pull request #1290)
608
609 - Fixed a regression introduced in 0.8.1, where the last tick label would
610 sometimes wrap rather than extending the plot's offset to create space.
611 (reported by Elite Gamer, issue #1283)
612
613 - Fixed a regression introduced in 0.8.2, where the resize plugin would use
614 unexpectedly high amounts of CPU even when idle.
615 (reported by tommie, issue #1277, pull request #1289)
616
617 - Fixed the selection example to work with jQuery 1.9.x and later.
618 (reported by EGLadona and dmfalke, issue #1250, pull request #1285)
619
620 - Added a detach shim to fix support for jQuery versions earlier than 1.4.x.
621 (reported by ngavard, issue #1240, pull request #1286)
622
623 - Fixed a rare 'Uncaught TypeError' when using the resize plugin in IE 7/8.
624 (reported by tleish, issue #1265, pull request #1289)
625
626 - Fixed zoom constraints to apply only in the direction of the zoom.
627 (patch by Neil Katin, issue #1204, pull request #1205)
628
629 - Markings lines are no longer blurry when drawn on pixel boundaries.
630 (reported by btccointicker and Rouillard, issue #1210)
631
632 - Don't discard original pie data-series values when combining slices.
633 (patch by Phil Tsarik, pull request #1238)
634
635 - Fixed broken auto-scale behavior when using deprecated [x|y]2axis options.
636 (reported by jorese, issue #1228, pull request #1284)
637
638 - Exposed the dateGenerator function on the plot object, as it used to be
639 before time-mode was moved into a separate plugin.
640 (patch by Paolo Valleri, pull request #1028)
641
642
643## Flot 0.8.2 ##
644
645### Changes ###
646
647 - Added a plot.destroy method as a way to free memory when emptying the plot
648 placeholder and then re-using it for some other purpose.
649 (patch by Thodoris Greasidis, issue #1129, pull request #1130)
650
651 - Added a table of contents and PLUGINS link to the API documentation.
652 (patches by Brian Peiris, pull requests #1064 and #1127)
653
654 - Added Ruby code examples for time conversion.
655 (patch by Mike Połtyn, pull request #1182)
656
657 - Minor improvements to API.md and README.md.
658 (patches by Patrik Ragnarsson, pull requests #1085 and #1086)
659
660 - Updated inlined jQuery Resize to the latest version to fix errors.
661 (reported by Matthew Sabol and sloker, issues #997 ad #1081)
662
663### Bug fixes ###
664
665 - Fixed an unexpected change in behavior that resulted in duplicate tick
666 labels when using a plugin, like flot-tickrotor, that overrode tick labels.
667 (patch by Mark Cote, pull request #1091)
668
669 - Fixed a regression from 0.7 where axis labels were given the wrong width,
670 causing them to overlap at certain scales and ignore the labelWidth option.
671 (patch by Benjamin Gram, pull request #1177)
672
673 - Fixed a bug where the second axis in an xaxes/yaxes array incorrectly had
674 its 'innermost' property set to false or undefined, even if it was on the
675 other side of the plot from the first axis. This resulted in the axis bar
676 being visible when it shouldn't have been, which was especially obvious
677 when the grid had a left/right border width of zero.
678 (reported by Teq1, fix researched by ryleyb, issue #1056)
679
680 - Fixed an error when using a placeholder that has no font-size property.
681 (patch by Craig Oldford, pull request #1135)
682
683 - Fixed a regression from 0.7 where nulls at the end of a series were ignored
684 for purposes of determing the range of the x-axis.
685 (reported by Munsifali Rashid, issue #1095)
686
687 - If a font size is provided, base the default lineHeight on that size rather
688 that the font size of the plot placeholder, which may be very different.
689 (reported by Daniel Hoffmann Bernardes, issue #1131, pull request #1199)
690
691 - Fix broken highlighting for right-aligned bars.
692 (reported by BeWiBu and Mihai Stanciu, issues #975 and #1093, with further
693 assistance by Eric Byers, pull request #1120)
694
695 - Prevent white circles from sometimes showing up inside of pie charts.
696 (reported by Pierre Dubois and Jack Klink, issues #1128 and #1073)
697
698 - Label formatting no longer breaks when a page contains multiple pie charts.
699 (reported by Brend Wanders, issue #1055)
700
701 - When using multiple axes on opposite sides of the plot, the innermost axis
702 coming later in the list no longer has its bar drawn incorrectly.
703 (reported by ryleyb, issue #1056)
704
705 - When removing series labels and redrawing the plot, the legend now updates
706 correctly even when using an external container.
707 (patch by Luis Silva, issue #1159, pull request #1160)
708
709 - The pie plugin no longer ignores the value of the left offset option.
710 (reported by melanker, issue #1136)
711
712 - Fixed a regression from 0.7, where extra padding was added unnecessarily to
713 sides of the plot where there was no last tick label.
714 (reported by sknob001, issue #1048, pull request #1200)
715
716 - Fixed incorrect tooltip behavior in the interacting example.
717 (patch by cleroux, issue #686, pull request #1074)
718
719 - Fixed an error in CSS color extraction with elements outside the DOM.
720 (patch by execjosh, pull request #1084)
721
722 - Fixed :not selector error when using jQuery without Sizzle.
723 (patch by Anthony Ryan, pull request #1180)
724
725 - Worked around a browser issue that caused bars to appear un-filled.
726 (reported by irbian, issue #915)
727
728## Flot 0.8.1 ##
729
730### Bug fixes ###
731
732 - Fixed a regression in the time plugin, introduced in 0.8, that caused dates
733 to align to the minute rather than to the highest appropriate unit. This
734 caused many x-axes in 0.8 to have different ticks than they did in 0.7.
735 (reported by Tom Sheppard, patch by Daniel Shapiro, issue #1017, pull
736 request #1023)
737
738 - Fixed a regression in text rendering, introduced in 0.8, that caused axis
739 labels with the same text as another label on the same axis to disappear.
740 More generally, it's again possible to have the same text in two locations.
741 (issue #1032)
742
743 - Fixed a regression in text rendering, introduced in 0.8, where axis labels
744 were no longer assigned an explicit width, and their text could not wrap.
745 (reported by sabregreen, issue #1019)
746
747 - Fixed a regression in the pie plugin, introduced in 0.8, that prevented it
748 from accepting data in the format '[[x, y]]'.
749 (patch by Nicolas Morel, pull request #1024)
750
751 - The 'zero' series option and 'autoscale' format option are no longer
752 ignored when the series contains a null value.
753 (reported by Daniel Shapiro, issue #1033)
754
755 - Avoid triggering the time-mode plugin exception when there are zero series.
756 (reported by Daniel Rothig, patch by Mark Raymond, issue #1016)
757
758 - When a custom color palette has fewer colors than the default palette, Flot
759 no longer fills out the colors with the remainder of the default.
760 (patch by goorpy, issue #1031, pull request #1034)
761
762 - Fixed missing update for bar highlights after a zoom or other redraw.
763 (reported by Paolo Valleri, issue #1030)
764
765 - Fixed compatibility with jQuery versions earlier than 1.7.
766 (patch by Lee Willis, issue #1027, pull request #1027)
767
768 - The mouse wheel no longer scrolls the page when using the navigate plugin.
769 (patch by vird, pull request #1020)
770
771 - Fixed missing semicolons in the core library.
772 (reported by Michal Zglinski)
773
774
775## Flot 0.8.0 ##
776
777### API changes ###
778
779Support for time series has been moved into a plugin, jquery.flot.time.js.
780This results in less code if time series are not used. The functionality
781remains the same (plus timezone support, as described below); however, the
782plugin must be included if axis.mode is set to "time".
783
784When the axis mode is "time", the axis option "timezone" can be set to null,
785"browser", or a particular timezone (e.g. "America/New_York") to control how
786the dates are displayed. If null, the dates are displayed as UTC. If
787"browser", the dates are displayed in the time zone of the user's browser.
788
789Date/time formatting has changed and now follows a proper subset of the
790standard strftime specifiers, plus one nonstandard specifier for quarters.
791Additionally, if a strftime function is found in the Date object's prototype,
792it will be used instead of the built-in formatter.
793
794Axis tick labels now use the class 'flot-tick-label' instead of 'tickLabel'.
795The text containers for each axis now use the classes 'flot-[x|y]-axis' and
796'flot-[x|y]#-axis' instead of '[x|y]Axis' and '[x|y]#Axis'. For compatibility
797with Flot 0.7 and earlier text will continue to use the old classes as well,
798but they are considered deprecated and will be removed in a future version.
799
800In previous versions the axis 'color' option was used to set the color of tick
801marks and their label text. It now controls the color of the axis line, which
802previously could not be changed separately, and continues to act as a default
803for the tick-mark color. The color of tick label text is now set either by
804overriding the 'flot-tick-label' CSS rule or via the axis 'font' option.
805
806A new plugin, jquery.flot.canvas.js, allows axis tick labels to be rendered
807directly to the canvas, rather than using HTML elements. This feature can be
808toggled with a simple option, making it easy to create interactive plots in the
809browser using HTML, then re-render them to canvas for export as an image.
810
811The plugin tries to remain as faithful as possible to the original HTML render,
812and goes so far as to automatically extract styles from CSS, to avoid having to
813provide a separate set of styles when rendering to canvas. Due to limitations
814of the canvas text API, the plugin cannot reproduce certain features, including
815HTML markup embedded in labels, and advanced text styles such as 'em' units.
816
817The plugin requires support for canvas text, which may not be present in some
818older browsers, even if they support the canvas tag itself. To use the plugin
819with these browsers try using a shim such as canvas-text or FlashCanvas.
820
821The base and overlay canvas are now using the CSS classes "flot-base" and
822"flot-overlay" to prevent accidental clashes (issue 540).
823
824### Changes ###
825
826 - Addition of nonstandard %q specifier to date/time formatting. (patch
827 by risicle, issue 49)
828
829 - Date/time formatting follows proper subset of strftime specifiers, and
830 support added for Date.prototype.strftime, if found. (patch by Mark Cote,
831 issues 419 and 558)
832
833 - Fixed display of year ticks. (patch by Mark Cote, issue 195)
834
835 - Support for time series moved to plugin. (patch by Mark Cote)
836
837 - Display time series in different time zones. (patch by Knut Forkalsrud,
838 issue 141)
839
840 - Added a canvas plugin to enable rendering axis tick labels to the canvas.
841 (sponsored by YCharts.com, implementation by Ole Laursen and David Schnur)
842
843 - Support for setting the interval between redraws of the overlay canvas with
844 redrawOverlayInterval. (suggested in issue 185)
845
846 - Support for multiple thresholds in thresholds plugin. (patch by Arnaud
847 Bellec, issue 523)
848
849 - Support for plotting categories/textual data directly with new categories
850 plugin.
851
852 - Tick generators now get the whole axis rather than just min/max.
853
854 - Added processOffset and drawBackground hooks. (suggested in issue 639)
855
856 - Added a grid "margin" option to set the space between the canvas edge and
857 the grid.
858
859 - Prevent the pie example page from generating single-slice pies. (patch by
860 Shane Reustle)
861
862 - In addition to "left" and "center", bars now recognize "right" as an
863 alignment option. (patch by Michael Mayer, issue 520)
864
865 - Switched from toFixed to a much faster default tickFormatter. (patch by
866 Clemens Stolle)
867
868 - Added to a more helpful error when using a time-mode axis without including
869 the flot.time plugin. (patch by Yael Elmatad)
870
871 - Added a legend "sorted" option to control sorting of legend entries
872 independent of their series order. (patch by Tom Cleaveland)
873
874 - Added a series "highlightColor" option to control the color of the
875 translucent overlay that identifies the dataset when the mouse hovers over
876 it. (patch by Eric Wendelin and Nate Abele, issues 168 and 299)
877
878 - Added a plugin jquery.flot.errorbars, with an accompanying example, that
879 adds the ability to plot error bars, commonly used in many kinds of
880 statistical data visualizations. (patch by Rui Pereira, issue 215)
881
882 - The legend now omits entries whose labelFormatter returns null. (patch by
883 Tom Cleaveland, Christopher Lambert, and Simon Strandgaard)
884
885 - Added support for high pixel density (retina) displays, resulting in much
886 crisper charts on such devices. (patch by Olivier Guerriat, additional
887 fixes by Julien Thomas, maimairel, and Lau Bech Lauritzen)
888
889 - Added the ability to control pie shadow position and alpha via a new pie
890 'shadow' option. (patch by Julien Thomas, pull request #78)
891
892 - Added the ability to set width and color for individual sides of the grid.
893 (patch by Ara Anjargolian, additional fixes by Karl Swedberg, pull requests #855
894 and #880)
895
896 - The selection plugin's getSelection now returns null when the selection
897 has been cleared. (patch by Nick Campbell, pull request #852)
898
899 - Added a new option called 'zero' to bars and filled lines series, to control
900 whether the y-axis minimum is scaled to fit the data or set to zero.
901 (patch by David Schnur, issues #316, #529, and #856, pull request #911)
902
903 - The plot function is now also a jQuery chainable property.
904 (patch by David Schnur, issues #734 and #816, pull request #953)
905
906 - When only a single pie slice is beneath the combine threshold it is no longer
907 replaced by an 'other' slice. (suggested by Devin Bayer, issue #638)
908
909 - Added lineJoin and minSize options to the selection plugin to control the
910 corner style and minimum size of the selection, respectively.
911 (patch by Ruth Linehan, pull request #963)
912
913### Bug fixes ###
914
915 - Fix problem with null values and pie plugin. (patch by gcruxifix,
916 issue 500)
917
918 - Fix problem with threshold plugin and bars. (based on patch by
919 kaarlenkaski, issue 348)
920
921 - Fix axis box calculations so the boxes include the outermost part of the
922 labels too.
923
924 - Fix problem with event clicking and hovering in IE 8 by updating Excanvas
925 and removing previous work-around. (test case by Ara Anjargolian)
926
927 - Fix issues with blurry 1px border when some measures aren't integer.
928 (reported by Ara Anjargolian)
929
930 - Fix bug with formats in the data processor. (reported by Peter Hull,
931 issue 534)
932
933 - Prevent i from being declared global in extractRange. (reported by
934 Alexander Obukhov, issue 627)
935
936 - Throw errors in a more cross-browser-compatible manner. (patch by
937 Eddie Kay)
938
939 - Prevent pie slice outlines from being drawn when the stroke width is zero.
940 (reported by Chris Minett, issue 585)
941
942 - Updated the navigate plugin's inline copy of jquery.mousewheel to fix
943 Webkit zoom problems. (reported by Hau Nguyen, issue 685)
944
945 - Axis labels no longer appear as decimals rather than integers in certain
946 cases. (patch by Clemens Stolle, issue 541)
947
948 - Automatic color generation no longer produces only whites and blacks when
949 there are many series. (patch by David Schnur and Tom Cleaveland)
950
951 - Fixed an error when custom tick labels weren't provided as strings. (patch
952 by Shad Downey)
953
954 - Prevented the local insertSteps and fmt variables from becoming global.
955 (first reported by Marc Bennewitz and Szymon Barglowski, patch by Nick
956 Campbell, issues #825 and #831, pull request #851)
957
958 - Prevented several threshold plugin variables from becoming global. (patch
959 by Lasse Dahl Ebert)
960
961 - Fixed various jQuery 1.8 compatibility issues. (issues #814 and #819,
962 pull request #877)
963
964 - Pie charts with a slice equal to or approaching 100% of the pie no longer
965 appear invisible. (patch by David Schnur, issues #444, #658, #726, #824
966 and #850, pull request #879)
967
968 - Prevented several local variables from becoming global. (patch by aaa707)
969
970 - Ensure that the overlay and primary canvases remain aligned. (issue #670,
971 pull request #901)
972
973 - Added support for jQuery 1.9 by removing and replacing uses of $.browser.
974 (analysis and patch by Anthony Ryan, pull request #905)
975
976 - Pie charts no longer disappear when redrawn during a resize or update.
977 (reported by Julien Bec, issue #656, pull request #910)
978
979 - Avoided floating-point precision errors when calculating pie percentages.
980 (patch by James Ward, pull request #918)
981
982 - Fixed compatibility with jQuery 1.2.6, which has no 'mouseleave' shortcut.
983 (reported by Bevan, original pull request #920, replaced by direct patch)
984
985 - Fixed sub-pixel rendering issues with crosshair and selection lines.
986 (patches by alanayoub and Daniel Shapiro, pull requests #17 and #925)
987
988 - Fixed rendering issues when using the threshold plugin with several series.
989 (patch by Ivan Novikov, pull request #934)
990
991 - Pie charts no longer disappear when redrawn after calling setData().
992 (reported by zengge1984 and pareeohnos, issues #810 and #945)
993
994 - Added a work-around for the problem where points with a lineWidth of zero
995 still showed up with a visible line. (reported by SalvoSav, issue #842,
996 patch by Jamie Hamel-Smith, pull request #937)
997
998 - Pie charts now accept values in string form, like other plot types.
999 (reported by laerdal.no, issue #534)
1000
1001 - Avoid rounding errors in the threshold plugin.
1002 (reported by jerikojerk, issue #895)
1003
1004 - Fixed an error when using the navigate plugin with jQuery 1.9.x or later.
1005 (reported by Paolo Valleri, issue #964)
1006
1007 - Fixed inconsistencies between the highlight and unhighlight functions.
1008 (reported by djamshed, issue #987)
1009
1010 - Fixed recalculation of tickSize and tickDecimals on calls to setupGrid.
1011 (patch by thecountofzero, pull request #861, issues #860, #1000)
1012
1013
1014## Flot 0.7 ##
1015
1016### API changes ###
1017
1018Multiple axes support. Code using dual axes should be changed from using
1019x2axis/y2axis in the options to using an array (although backwards-
1020compatibility hooks are in place). For instance,
1021
1022```js
1023{
1024 xaxis: { ... }, x2axis: { ... },
1025 yaxis: { ... }, y2axis: { ... }
1026}
1027```
1028
1029becomes
1030
1031```js
1032{
1033 xaxes: [ { ... }, { ... } ],
1034 yaxes: [ { ... }, { ... } ]
1035}
1036```
1037
1038Note that if you're just using one axis, continue to use the xaxis/yaxis
1039directly (it now sets the default settings for the arrays). Plugins touching
1040the axes must be ported to take the extra axes into account, check the source
1041to see some examples.
1042
1043A related change is that the visibility of axes is now auto-detected. So if
1044you were relying on an axis to show up even without any data in the chart, you
1045now need to set the axis "show" option explicitly.
1046
1047"tickColor" on the grid options is now deprecated in favour of a corresponding
1048option on the axes, so:
1049
1050```js
1051{ grid: { tickColor: "#000" }}
1052```
1053
1054becomes
1055
1056```js
1057{ xaxis: { tickColor: "#000"}, yaxis: { tickColor: "#000"} }
1058```
1059
1060But if you just configure a base color Flot will now autogenerate a tick color
1061by adding transparency. Backwards-compatibility hooks are in place.
1062
1063Final note: now that IE 9 is coming out with canvas support, you may want to
1064adapt the excanvas include to skip loading it in IE 9 (the examples have been
1065adapted thanks to Ryley Breiddal). An alternative to excanvas using Flash has
1066also surfaced, if your graphs are slow in IE, you may want to give it a spin:
1067
1068 http://code.google.com/p/flashcanvas/
1069
1070### Changes ###
1071
1072 - Support for specifying a bottom for each point for line charts when filling
1073 them, this means that an arbitrary bottom can be used instead of just the x
1074 axis. (based on patches patiently provided by Roman V. Prikhodchenko)
1075
1076 - New fillbetween plugin that can compute a bottom for a series from another
1077 series, useful for filling areas between lines.
1078
1079 See new example percentiles.html for a use case.
1080
1081 - More predictable handling of gaps for the stacking plugin, now all
1082 undefined ranges are skipped.
1083
1084 - Stacking plugin can stack horizontal bar charts.
1085
1086 - Navigate plugin now redraws the plot while panning instead of only after
1087 the fact. (raised by lastthemy, issue 235)
1088
1089 Can be disabled by setting the pan.frameRate option to null.
1090
1091 - Date formatter now accepts %0m and %0d to get a zero-padded month or day.
1092 (issue raised by Maximillian Dornseif)
1093
1094 - Revamped internals to support an unlimited number of axes, not just dual.
1095 (sponsored by Flight Data Services, www.flightdataservices.com)
1096
1097 - New setting on axes, "tickLength", to control the size of ticks or turn
1098 them off without turning off the labels.
1099
1100 - Axis labels are now put in container divs with classes, for instance labels
1101 in the x axes can be reached via ".xAxis .tickLabel".
1102
1103 - Support for setting the color of an axis. (sponsored by Flight Data
1104 Services, www.flightdataservices.com)
1105
1106 - Tick color is now auto-generated as the base color with some transparency,
1107 unless you override it.
1108
1109 - Support for aligning ticks in the axes with "alignTicksWithAxis" to ensure
1110 that they appear next to each other rather than in between, at the expense
1111 of possibly awkward tick steps. (sponsored by Flight Data Services,
1112 www.flightdataservices.com)
1113
1114 - Support for customizing the point type through a callback when plotting
1115 points and new symbol plugin with some predefined point types. (sponsored
1116 by Utility Data Corporation)
1117
1118 - Resize plugin for automatically redrawing when the placeholder changes
1119 size, e.g. on window resizes. (sponsored by Novus Partners)
1120
1121 A resize() method has been added to plot object facilitate this.
1122
1123 - Support Infinity/-Infinity for plotting asymptotes by hacking it into
1124 +/-Number.MAX_VALUE. (reported by rabaea.mircea)
1125
1126 - Support for restricting navigate plugin to not pan/zoom an axis. (based on
1127 patch by kkaefer)
1128
1129 - Support for providing the drag cursor for the navigate plugin as an option.
1130 (based on patch by Kelly T. Moore)
1131
1132 - Options for controlling whether an axis is shown or not (suggestion by Timo
1133 Tuominen) and whether to reserve space for it even if it isn't shown.
1134
1135 - New attribute $.plot.version with the Flot version as a string.
1136
1137 - The version comment is now included in the minified jquery.flot.min.js.
1138
1139 - New options.grid.minBorderMargin for adjusting the minimum margin provided
1140 around the border (based on patch by corani, issue 188).
1141
1142 - Refactor replot behaviour so Flot tries to reuse the existing canvas,
1143 adding shutdown() methods to the plot. (based on patch by Ryley Breiddal,
1144 issue 269)
1145
1146 This prevents a memory leak in Chrome and hopefully makes replotting faster
1147 for those who are using $.plot instead of .setData()/.draw(). Also update
1148 jQuery to 1.5.1 to prevent IE leaks fixed in jQuery.
1149
1150 - New real-time line chart example.
1151
1152 - New hooks: drawSeries, shutdown.
1153
1154### Bug fixes ###
1155
1156 - Fixed problem with findNearbyItem and bars on top of each other. (reported
1157 by ragingchikn, issue 242)
1158
1159 - Fixed problem with ticks and the border. (based on patch from
1160 ultimatehustler69, issue 236)
1161
1162 - Fixed problem with plugins adding options to the series objects.
1163
1164 - Fixed a problem introduced in 0.6 with specifying a gradient with:
1165
1166 ```{brightness: x, opacity: y }```
1167
1168 - Don't use $.browser.msie, check for getContext on the created canvas element
1169 instead and try to use excanvas if it's not found.
1170
1171 Fixes IE 9 compatibility.
1172
1173 - highlight(s, index) was looking up the point in the original s.data instead
1174 of in the computed datapoints array, which breaks with plugins that modify
1175 the datapoints, such as the stacking plugin. (reported by curlypaul924,
1176 issue 316)
1177
1178 - More robust handling of axis from data passed in from getData(). (reported)
1179 by Morgan)
1180
1181 - Fixed problem with turning off bar outline. (fix by Jordi Castells,
1182 issue 253)
1183
1184 - Check the selection passed into setSelection in the selection
1185 plugin, to guard against errors when synchronizing plots (fix by Lau
1186 Bech Lauritzen).
1187
1188 - Fix bug in crosshair code with mouseout resetting the crosshair even
1189 if it is locked (fix by Lau Bech Lauritzen and Banko Adam).
1190
1191 - Fix bug with points plotting using line width from lines rather than
1192 points.
1193
1194 - Fix bug with passing non-array 0 data (for plugins that don't expect
1195 arrays, patch by vpapp1).
1196
1197 - Fix errors in JSON in examples so they work with jQuery 1.4.2
1198 (fix reported by honestbleeps, issue 357).
1199
1200 - Fix bug with tooltip in interacting.html, this makes the tooltip
1201 much smoother (fix by bdkahn). Fix related bug inside highlighting
1202 handler in Flot.
1203
1204 - Use closure trick to make inline colorhelpers plugin respect
1205 jQuery.noConflict(true), renaming the global jQuery object (reported
1206 by Nick Stielau).
1207
1208 - Listen for mouseleave events and fire a plothover event with empty
1209 item when it occurs to drop highlights when the mouse leaves the
1210 plot (reported by by outspirit).
1211
1212 - Fix bug with using aboveData with a background (reported by
1213 amitayd).
1214
1215 - Fix possible excanvas leak (report and suggested fix by tom9729).
1216
1217 - Fix bug with backwards compatibility for shadowSize = 0 (report and
1218 suggested fix by aspinak).
1219
1220 - Adapt examples to skip loading excanvas (fix by Ryley Breiddal).
1221
1222 - Fix bug that prevent a simple f(x) = -x transform from working
1223 correctly (fix by Mike, issue 263).
1224
1225 - Fix bug in restoring cursor in navigate plugin (reported by Matteo
1226 Gattanini, issue 395).
1227
1228 - Fix bug in picking items when transform/inverseTransform is in use
1229 (reported by Ofri Raviv, and patches and analysis by Jan and Tom
1230 Paton, issue 334 and 467).
1231
1232 - Fix problem with unaligned ticks and hover/click events caused by
1233 padding on the placeholder by hardcoding the placeholder padding to
1234 0 (reported by adityadineshsaxena, Matt Sommer, Daniel Atos and some
1235 other people, issue 301).
1236
1237 - Update colorhelpers plugin to avoid dying when trying to parse an
1238 invalid string (reported by cadavor, issue 483).
1239
1240
1241
1242## Flot 0.6 ##
1243
1244### API changes ###
1245
1246Selection support has been moved to a plugin. Thus if you're passing
1247selection: { mode: something }, you MUST include the file
1248jquery.flot.selection.js after jquery.flot.js. This reduces the size of
1249base Flot and makes it easier to customize the selection as well as
1250improving code clarity. The change is based on a patch from andershol.
1251
1252In the global options specified in the $.plot command, "lines", "points",
1253"bars" and "shadowSize" have been moved to a sub-object called "series":
1254
1255```js
1256$.plot(placeholder, data, { lines: { show: true }})
1257```
1258
1259should be changed to
1260
1261```js
1262 $.plot(placeholder, data, { series: { lines: { show: true }}})
1263```
1264
1265All future series-specific options will go into this sub-object to
1266simplify plugin writing. Backward-compatibility code is in place, so
1267old code should not break.
1268
1269"plothover" no longer provides the original data point, but instead a
1270normalized one, since there may be no corresponding original point.
1271
1272Due to a bug in previous versions of jQuery, you now need at least
1273jQuery 1.2.6. But if you can, try jQuery 1.3.2 as it got some improvements
1274in event handling speed.
1275
1276## Changes ##
1277
1278 - Added support for disabling interactivity for specific data series.
1279 (request from Ronald Schouten and Steve Upton)
1280
1281 - Flot now calls $() on the placeholder and optional legend container passed
1282 in so you can specify DOM elements or CSS expressions to make it easier to
1283 use Flot with libraries like Prototype or Mootools or through raw JSON from
1284 Ajax responses.
1285
1286 - A new "plotselecting" event is now emitted while the user is making a
1287 selection.
1288
1289 - The "plothover" event is now emitted immediately instead of at most 10
1290 times per second, you'll have to put in a setTimeout yourself if you're
1291 doing something really expensive on this event.
1292
1293 - The built-in date formatter can now be accessed as $.plot.formatDate(...)
1294 (suggestion by Matt Manela) and even replaced.
1295
1296 - Added "borderColor" option to the grid. (patches from Amaury Chamayou and
1297 Mike R. Williamson)
1298
1299 - Added support for gradient backgrounds for the grid. (based on patch from
1300 Amaury Chamayou, issue 90)
1301
1302 The "setting options" example provides a demonstration.
1303
1304 - Gradient bars. (suggestion by stefpet)
1305
1306 - Added a "plotunselected" event which is triggered when the selection is
1307 removed, see "selection" example. (suggestion by Meda Ugo)
1308
1309 - The option legend.margin can now specify horizontal and vertical margins
1310 independently. (suggestion by someone who's annoyed)
1311
1312 - Data passed into Flot is now copied to a new canonical format to enable
1313 further processing before it hits the drawing routines. As a side-effect,
1314 this should make Flot more robust in the face of bad data. (issue 112)
1315
1316 - Step-wise charting: line charts have a new option "steps" that when set to
1317 true connects the points with horizontal/vertical steps instead of diagonal
1318 lines.
1319
1320 - The legend labelFormatter now passes the series in addition to just the
1321 label. (suggestion by Vincent Lemeltier)
1322
1323 - Horizontal bars (based on patch by Jason LeBrun).
1324
1325 - Support for partial bars by specifying a third coordinate, i.e. they don't
1326 have to start from the axis. This can be used to make stacked bars.
1327
1328 - New option to disable the (grid.show).
1329
1330 - Added pointOffset method for converting a point in data space to an offset
1331 within the placeholder.
1332
1333 - Plugin system: register an init method in the $.flot.plugins array to get
1334 started, see PLUGINS.txt for details on how to write plugins (it's easy).
1335 There are also some extra methods to enable access to internal state.
1336
1337 - Hooks: you can register functions that are called while Flot is crunching
1338 the data and doing the plot. This can be used to modify Flot without
1339 changing the source, useful for writing plugins. Some hooks are defined,
1340 more are likely to come.
1341
1342 - Threshold plugin: you can set a threshold and a color, and the data points
1343 below that threshold will then get the color. Useful for marking data
1344 below 0, for instance.
1345
1346 - Stack plugin: you can specify a stack key for each series to have them
1347 summed. This is useful for drawing additive/cumulative graphs with bars and
1348 (currently unfilled) lines.
1349
1350 - Crosshairs plugin: trace the mouse position on the axes, enable with
1351 crosshair: { mode: "x"} (see the new tracking example for a use).
1352
1353 - Image plugin: plot prerendered images.
1354
1355 - Navigation plugin for panning and zooming a plot.
1356
1357 - More configurable grid.
1358
1359 - Axis transformation support, useful for non-linear plots, e.g. log axes and
1360 compressed time axes (like omitting weekends).
1361
1362 - Support for twelve-hour date formatting (patch by Forrest Aldridge).
1363
1364 - The color parsing code in Flot has been cleaned up and split out so it's
1365 now available as a separate jQuery plugin. It's included inline in the Flot
1366 source to make dependency managing easier. This also makes it really easy
1367 to use the color helpers in Flot plugins.
1368
1369## Bug fixes ##
1370
1371 - Fixed two corner-case bugs when drawing filled curves. (report and analysis
1372 by Joshua Varner)
1373
1374 - Fix auto-adjustment code when setting min to 0 for an axis where the
1375 dataset is completely flat on that axis. (report by chovy)
1376
1377 - Fixed a bug with passing in data from getData to setData when the secondary
1378 axes are used. (reported by nperelman, issue 65)
1379
1380 - Fixed so that it is possible to turn lines off when no other chart type is
1381 shown (based on problem reported by Glenn Vanderburg), and fixed so that
1382 setting lineWidth to 0 also hides the shadow. (based on problem reported by
1383 Sergio Nunes)
1384
1385 - Updated mousemove position expression to the latest from jQuery. (reported
1386 by meyuchas)
1387
1388 - Use CSS borders instead of background in legend. (issues 25 and 45)
1389
1390 - Explicitly convert axis min/max to numbers.
1391
1392 - Fixed a bug with drawing marking lines with different colors. (reported by
1393 Khurram)
1394
1395 - Fixed a bug with returning y2 values in the selection event. (fix by
1396 exists, issue 75)
1397
1398 - Only set position relative on placeholder if it hasn't already a position
1399 different from static. (reported by kyberneticist, issue 95)
1400
1401 - Don't round markings to prevent sub-pixel problems. (reported by
1402 Dan Lipsitt)
1403
1404 - Make the grid border act similarly to a regular CSS border, i.e. prevent
1405 it from overlapping the plot itself. This also fixes a problem with anti-
1406 aliasing when the width is 1 pixel. (reported by Anthony Ettinger)
1407
1408 - Imported version 3 of excanvas and fixed two issues with the newer version.
1409 Hopefully, this will make Flot work with IE8. (nudge by Fabien Menager,
1410 further analysis by Booink, issue 133)
1411
1412 - Changed the shadow code for lines to hopefully look a bit better with
1413 vertical lines.
1414
1415 - Round tick positions to avoid possible problems with fractions. (suggestion
1416 by Fred, issue 130)
1417
1418 - Made the heuristic for determining how many ticks to aim for a bit smarter.
1419
1420 - Fix for uneven axis margins (report and patch by Paul Kienzle) and snapping
1421 to ticks. (report and patch by lifthrasiir)
1422
1423 - Fixed bug with slicing in findNearbyItems. (patch by zollman)
1424
1425 - Make heuristic for x axis label widths more dynamic. (patch by
1426 rickinhethuis)
1427
1428 - Make sure points on top take precedence when finding nearby points when
1429 hovering. (reported by didroe, issue 224)
1430
1431
1432
1433## Flot 0.5 ##
1434
1435Timestamps are now in UTC. Also "selected" event -> becomes "plotselected"
1436with new data, the parameters for setSelection are now different (but
1437backwards compatibility hooks are in place), coloredAreas becomes markings
1438with a new interface (but backwards compatibility hooks are in place).
1439
1440### API changes ###
1441
1442Timestamps in time mode are now displayed according to UTC instead of the time
1443zone of the visitor. This affects the way the timestamps should be input;
1444you'll probably have to offset the timestamps according to your local time
1445zone. It also affects any custom date handling code (which basically now
1446should use the equivalent UTC date mehods, e.g. .setUTCMonth() instead of
1447.setMonth().
1448
1449Markings, previously coloredAreas, are now specified as ranges on the axes,
1450like ```{ xaxis: { from: 0, to: 10 }}```. Furthermore with markings you can
1451now draw horizontal/vertical lines by setting from and to to the same
1452coordinate. (idea from line support patch by by Ryan Funduk)
1453
1454Interactivity: added a new "plothover" event and this and the "plotclick"
1455event now returns the closest data item (based on patch by /david, patch by
1456Mark Byers for bar support). See the revamped "interacting with the data"
1457example for some hints on what you can do.
1458
1459Highlighting: you can now highlight points and datapoints are autohighlighted
1460when you hover over them (if hovering is turned on).
1461
1462Support for dual axis has been added (based on patch by someone who's annoyed
1463and /david). For each data series you can specify which axes it belongs to,
1464and there are two more axes, x2axis and y2axis, to customize. This affects the
1465"selected" event which has been renamed to "plotselected" and spews out
1466```{ xaxis: { from: -10, to: 20 } ... },``` setSelection in which the
1467parameters are on a new form (backwards compatible hooks are in place so old
1468code shouldn't break) and markings (formerly coloredAreas).
1469
1470## Changes ##
1471
1472 - Added support for specifying the size of tick labels (axis.labelWidth,
1473 axis.labelHeight). Useful for specifying a max label size to keep multiple
1474 plots aligned.
1475
1476 - The "fill" option can now be a number that specifies the opacity of the
1477 fill.
1478
1479 - You can now specify a coordinate as null (like [2, null]) and Flot will
1480 take the other coordinate into account when scaling the axes. (based on
1481 patch by joebno)
1482
1483 - New option for bars "align". Set it to "center" to center the bars on the
1484 value they represent.
1485
1486 - setSelection now takes a second parameter which you can use to prevent the
1487 method from firing the "plotselected" handler.
1488
1489 - Improved the handling of axis auto-scaling with bars.
1490
1491## Bug fixes ##
1492
1493 - Fixed a bug in calculating spacing around the plot. (reported by
1494 timothytoe)
1495
1496 - Fixed a bug in finding max values for all-negative data sets.
1497
1498 - Prevent the possibility of eternal looping in tick calculations.
1499
1500 - Fixed a bug when borderWidth is set to 0. (reported by Rob/sanchothefat)
1501
1502 - Fixed a bug with drawing bars extending below 0. (reported by James Hewitt,
1503 patch by Ryan Funduk).
1504
1505 - Fixed a bug with line widths of bars. (reported by MikeM)
1506
1507 - Fixed a bug with 'nw' and 'sw' legend positions.
1508
1509 - Fixed a bug with multi-line x-axis tick labels. (reported by Luca Ciano,
1510 IE-fix help by Savage Zhang)
1511
1512 - Using the "container" option in legend now overwrites the container element
1513 instead of just appending to it, fixing the infinite legend bug. (reported
1514 by several people, fix by Brad Dewey)
1515
1516
1517
1518## Flot 0.4 ##
1519
1520### API changes ###
1521
1522Deprecated axis.noTicks in favor of just specifying the number as axis.ticks.
1523So ```xaxis: { noTicks: 10 }``` becomes ```xaxis: { ticks: 10 }```.
1524
1525Time series support. Specify axis.mode: "time", put in Javascript timestamps
1526as data, and Flot will automatically spit out sensible ticks. Take a look at
1527the two new examples. The format can be customized with axis.timeformat and
1528axis.monthNames, or if that fails with axis.tickFormatter.
1529
1530Support for colored background areas via grid.coloredAreas. Specify an array
1531of { x1, y1, x2, y2 } objects or a function that returns these given
1532{ xmin, xmax, ymin, ymax }.
1533
1534More members on the plot object (report by Chris Davies and others).
1535"getData" for inspecting the assigned settings on data series (e.g. color) and
1536"setData", "setupGrid" and "draw" for updating the contents without a total
1537replot.
1538
1539The default number of ticks to aim for is now dependent on the size of the
1540plot in pixels. Support for customizing tick interval sizes directly with
1541axis.minTickSize and axis.tickSize.
1542
1543Cleaned up the automatic axis scaling algorithm and fixed how it interacts
1544with ticks. Also fixed a couple of tick-related corner case bugs (one reported
1545by mainstreetmark, another reported by timothytoe).
1546
1547The option axis.tickFormatter now takes a function with two parameters, the
1548second parameter is an optional object with information about the axis. It has
1549min, max, tickDecimals, tickSize.
1550
1551## Changes ##
1552
1553 - Added support for segmented lines. (based on patch from Michael MacDonald)
1554
1555 - Added support for ignoring null and bad values. (suggestion from Nick
1556 Konidaris and joshwaihi)
1557
1558 - Added support for changing the border width. (thanks to joebno and safoo)
1559
1560 - Label colors can be changed via CSS by selecting the tickLabel class.
1561
1562## Bug fixes ##
1563
1564 - Fixed a bug in handling single-item bar series. (reported by Emil Filipov)
1565
1566 - Fixed erratic behaviour when interacting with the plot with IE 7. (reported
1567 by Lau Bech Lauritzen).
1568
1569 - Prevent IE/Safari text selection when selecting stuff on the canvas.
1570
1571
1572
1573## Flot 0.3 ##
1574
1575This is mostly a quick-fix release because jquery.js wasn't included in the
1576previous zip/tarball.
1577
1578## Changes ##
1579
1580 - Include jquery.js in the zip/tarball.
1581
1582 - Support clicking on the plot. Turn it on with grid: { clickable: true },
1583 then you get a "plotclick" event on the graph placeholder with the position
1584 in units of the plot.
1585
1586## Bug fixes ##
1587
1588 - Fixed a bug in dealing with data where min = max. (thanks to Michael
1589 Messinides)
1590
1591
1592
1593## Flot 0.2 ##
1594
1595The API should now be fully documented.
1596
1597### API changes ###
1598
1599Moved labelMargin option to grid from x/yaxis.
1600
1601## Changes ##
1602
1603 - Added support for putting a background behind the default legend. The
1604 default is the partly transparent background color. Added backgroundColor
1605 and backgroundOpacity to the legend options to control this.
1606
1607 - The ticks options can now be a callback function that takes one parameter,
1608 an object with the attributes min and max. The function should return a
1609 ticks array.
1610
1611 - Added labelFormatter option in legend, useful for turning the legend
1612 labels into links.
1613
1614 - Reduced the size of the code. (patch by Guy Fraser)
1615
1616
1617
1618## Flot 0.1 ##
1619
1620First public release.
1621
1622[1.1.5]: https://github.com/ni-kismet/engineering-flot/compare/v1.1.4...v1.1.5
1623[1.1.4]: https://github.com/ni-kismet/engineering-flot/compare/v1.1.3...v1.1.4
1624[1.1.3]: https://github.com/ni-kismet/engineering-flot/compare/v1.1.2...v1.1.3
1625[1.1.2]: https://github.com/ni-kismet/engineering-flot/compare/v1.1.0...v1.1.2
1626[1.1.0]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.10...v1.1.0
1627[1.0.10]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.9...v1.0.10
1628[1.0.9]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.8...v1.0.9
1629[1.0.8]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.7...v1.0.8
1630[1.0.7]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.6...v1.0.7
1631[1.0.6]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.5...v1.0.6
1632[1.0.5]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.4...v1.0.5
1633[1.0.4]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.3...v1.0.4
1634[1.0.3]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.2...v1.0.3
1635[1.0.2]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.1...v1.0.2
1636[1.0.1]: https://github.com/ni-kismet/engineering-flot/compare/v1.0.0...v1.0.1
1637[1.0.0]: https://github.com/ni-kismet/engineering-flot/compare/v0.6.0...v1.0.0
1638
\No newline at end of file