|Classes of Kishor Mali||>||CodeIgniter Admin Panel with User Management||>||assets/bower_components/Flot/PLUGINS.md||>||Download|
All you need to do to make a new plugin is creating an init function and a set of options (if needed), stuffing it into an object and putting it in the $.plot.plugins array. For example:
There's a complete example below, but you should also check out the plugins bundled with Flot.
Here is a simple debug plugin which alerts each of the series in the plot. It has a single option that control whether it is enabled and how much info to output:
We also define "name" and "version". It's not used by Flot, but might be helpful for other plugins in resolving dependencies.
Put the above in a file named "jquery.flot.debug.js", include it in an HTML page and then it can be used with:
This simple plugin illustrates a couple of points:
- It uses the anonymous function trick to avoid name pollution. - It can be enabled/disabled through an option. - Variables in the init function can be used to store plot-specific state between the hooks.
The two last points are important because there may be multiple plots on the same page, and you'd want to make sure they are not mixed up.
Shutting down a plugin
Each plot object has a shutdown hook which is run when plot.shutdown() is called. This usually mostly happens in case another plot is made on top of an existing one.
The purpose of the hook is to give you a chance to unbind any event handlers you've registered and remove any extra DOM things you've inserted.
The problem with event handlers is that you can have registered a handler which is run in some point in the future, e.g. with setTimeout(). Meanwhile, the plot may have been shutdown and removed, but because your event handler is still referencing it, it can't be garbage collected yet, and worse, if your handler eventually runs, it may overwrite stuff on a completely different plot.
Some hints on the options
Plugins should always support appropriate options to enable/disable them because the plugin user may have several plots on the same page where only one should use the plugin. In most cases it's probably a good idea if the plugin is turned off rather than on per default, just like most of the powerful features in Flot.
If the plugin needs options that are specific to each series, like the points or lines options in core Flot, you can put them in "series" in the options object, e.g.
Then they will be copied by Flot into each series, providing default values in case none are specified.
Think hard and long about naming the options. These names are going to be public API, and code is going to depend on them if the plugin is successful.