From 04254b923b02546c4921437edb1ca230c08a93b1 Mon Sep 17 00:00:00 2001 From: David Schnur Date: Mon, 16 Jul 2012 00:00:56 -0300 Subject: [PATCH] Cleanup and markup standardization. --- FAQ.md | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/FAQ.md b/FAQ.md index c3aba7e..9131e04 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,9 +1,8 @@ -Frequently asked questions --------------------------- +## Frequently asked questions ## -Q: How much data can Flot cope with? ------------------------------------- -A: Flot will happily draw everything you send to it so the answer +#### How much data can Flot cope with? #### + +Flot will happily draw everything you send to it so the answer depends on the browser. The excanvas emulation used for IE (built with VML) makes IE by far the slowest browser so be sure to test with that if IE users are in your target group (for large plots in IE, you can @@ -15,36 +14,36 @@ downsampling/aggregation as this is near the resolution limit of the chart anyway. If you downsample server-side, you also save bandwidth. -Q: Flot isn't working when I'm using JSON data as source! ---------------------------------------------------------- -A: Actually, Flot loves JSON data, you just got the format wrong. +#### Flot isn't working when I'm using JSON data as source! #### + +Actually, Flot loves JSON data, you just got the format wrong. Double check that you're not inputting strings instead of numbers, like [["0", "-2.13"], ["5", "4.3"]]. This is most common mistake, and the error might not show up immediately because Javascript can do some conversion automatically. -Q: Can I export the graph? --------------------------- -A: You can grab the image rendered by the canvas element used by Flot +#### Can I export the graph? #### + +You can grab the image rendered by the canvas element used by Flot as a PNG or JPEG (remember to set a background). Note that it won't include anything not drawn in the canvas (such as the legend). And it doesn't work with excanvas which uses VML, but you could try Flashcanvas. -Q: The bars are all tiny in time mode? --------------------------------------- -A: It's not really possible to determine the bar width automatically. +#### The bars are all tiny in time mode? #### + +It's not really possible to determine the bar width automatically. So you have to set the width with the barWidth option which is NOT in pixels, but in the units of the x axis (or the y axis for horizontal bars). For time mode that's milliseconds so the default value of 1 makes the bars 1 millisecond wide. -Q: Can I use Flot with libraries like Mootools or Prototype? ------------------------------------------------------------- -A: Yes, Flot supports it out of the box and it's easy! Just use jQuery +#### Can I use Flot with libraries like Mootools or Prototype? #### + +Yes, Flot supports it out of the box and it's easy! Just use jQuery instead of $, e.g. call jQuery.plot instead of $.plot and use jQuery(something) instead of $(something). As a convenience, you can put in a DOM element for the graph placeholder where the examples and @@ -56,9 +55,9 @@ libraries, see the documentation in jQuery ("Using jQuery with other libraries") for details. -Q: Flot doesn't work with [insert name of Javascript UI framework]! -------------------------------------------------------------------- -A: Flot is using standard HTML to make charts. If this is not working, +#### Flot doesn't work with [insert name of Javascript UI framework]! #### + +Flot is using standard HTML to make charts. If this is not working, it's probably because the framework you're using is doing something weird with the DOM or with the CSS that is interfering with Flot.