You are viewing documentation for an older version. For current documentation - click here.
JavaScript Charting capabilities

Starting FusionCharts v3.2, you can now render the charts on devices like iPhone/iPad using the in-built JavaScript rendering capabilities, powered by Highcharts library. The charts rendered by this module are purely JavaScript based and do not need Flash Player at all. FusionCharts license agreement includes a license for HighCharts, and as such you do not need to license it separately.

FusionCharts gives you the option of either using automatic fallback, wherein the charts figure out the best mode of rendering (either Flash or JavaScript, based on availability of Flash Player), or lets you configure whether to render charts exclusively using JavaScript. If you are already using FusionCharts and wish to add iPad/iPhone fallback, you just need to replace the old SWF and JS files with the new ones - without changing a single line of code.

In case you wish to render JavaScript based charts only, irrespective of whether Flash Player is installed or not, all you need to do is add a single line of code to your existing implementation. This has been covered in forthcoming sections. Meanwhile, let's take a small overview of FusionCharts JavaScript based charting capabilities.

How it works?

FusionCharts v3.2 features a completely new FusionCharts JavaScript class. FusionCharts JavaScript class now consists of three main files: FusionCharts.js, highcharts.js and jquery.min.js. These three files are present in Download Pack > Charts folder. Although you only need to include FusionCharts.js in your web page, highcharts.js and jquery.min.js must be present in the folder that contains FusionCharts.js.

FusionCharts.js dynamically loads the other JavaScript on-demand (i.e., if and when needed). Once FusionCharts class determines that the device is iPad/iPhone, it automatically switches the rendering mode to JavaScript. You can also forcefully set the rendering method to JavaScript from your code.  Additionally, you can setup the charts to render as JavaScript charts whenever Flash Player is not installed for the browser. You just need to call FusionCharts._fallbackJSChartWhenNoFlash() before you render a chart.

   
Chart types supported

Given below is the list of chart types supported by the FusionCharts JavaScript renderer:

Chart Type Flash SWF Name Equivalent JavaScript Chart
Single Series Charts
Column 3D Column3D.swf Column 2D
Column 2D Column2D.swf Column 2D
Line 2D Line.swf Line
Area 2D Area2D.swf Area 2D
Bar 2D Bar2D.swf Bar 2D
Pie 2D Pie2D.swf Pie 2D
Pie 3D Pie3D.swf Pie 2D
Doughnut 2D Doughnut2D.swf Doughnut 2D
Doughnut 3D Doughnut3D.swf Doughnut 2D
Pareto 2D Pareto2D.swf Pareto 2D
Pareto 3D Pareto3D.swf Pareto 2D
 
Multi-series Charts
Multi-series Column 2D MSColumn2D.swf MSColumn2D
Multi-series Column 3D MSColumn3D.swf MSColumn2D
Multi-series Line 2D MSLine.swf MSLine
Multi-series Bar 2D MSBar2D.swf MSBar2D
Multi-series Bar 3D MSBar3D.swf MSBar2D
Multi-series Area 2D MSArea.swf MSArea
Marimekko Marimekko.swf Marimekko
Zoom Line ZoomLine.swf ZoomLine
 
Stacked Charts
Stacked Column 3D StackedColumn3D.swf StackedColumn2D
Stacked Column 2D StackedColumn2D.swf StackedColumn2D
Stacked Bar 2D StackedBar2D.swf StackedBar2D
Stacked Bar 3D StackedBar3D.swf StackedBar2D
Stacked Area 2D StackedArea2D.swf StackedArea2D
Multi-series Stacked Column 2D MSStackedColumn2D.swf not supported as of now
 
Combination Charts
True 3D Chart (Multi-series 3D Single Y Combination chart - Column + Line + Area) MSCombi3D.swf MSCombi2D
Multi-series 2D Single Y Combination Chart (Column + Line + Area) MSCombi2D.swf MSCombi2D
Multi-series Column 3D + Multi-series Line - Single Y Axis MSColumnLine3D.swf MSCombi2D
Stacked Column2D + Line single Y Axis StackedColumn2DLine.swf StackedColumn2DLine
Stacked Column3D + Line single Y Axis StackedColumn3DLine.swf StackedColumn2DLine
Multi-series 2D Dual Y Combination Chart (Column + Line + Area) MSCombiDY2D.swf MSCombiDY2D
Multi-series Column 3D + Multi-series Line - Dual Y Axis MSColumn3DLineDY.swf MSCombiDY2D
Stacked Column 3D + Line Dual Y Axis StackedColumn3DLineDY.swf StackedColumn2DLineDualY
Multi-series Stacked Column 2D + Line Dual Y Axis MSStackedColumn2DLineDY.swf not supported as of now
 
XY Plot Charts
Scatter Chart Scatter.swf Scatter
Bubble Chart Bubble.swf Bubble
 
Scroll Charts
Scroll Column 2D ScrollColumn2D.swf ScrollColumn2D (non scroll)
Scroll Line 2D ScrollLine2D.swf ScrollLine2D (non scroll)
Scroll Area 2D ScrollArea2D.swf ScrollArea2D (non scroll)
Scroll Stacked Column 2D ScrollStackedColumn2D.swf StackedArea2D (non scroll)
Scroll Combination 2D (Single Y) ScrollCombi2D.swf MSCombi2D (non scroll)
Scroll Combination 2D (Dual Y) ScrollCombiDY2D.swf MSCombiDY2D (non scroll)
 
Others
Single Series Grid Component SSGrid.swf not supported as of now
Limitations

As of now, the FusionCharts JavaScript renderer has the following limitations:

  • The charts do not support 3D rendering. All 3D charts are automatically converted to 2D when using JavaScript renderer.
  • Some Flash Charts do not have JavaScript equivalent including Multi-series Stacked Column charts, Grid and scroll combination charts
  • Support for exporting of JavaScript charts as image/PDF is limited to server-side export only
  • Gradient rendering in JavaScript charts is limited
  • Color palettes (1-5) are not supported
  • plotbgcolor suppresses vLine (only if the plot has transparent color vLines are visible)
  • TrendLines are same as vLine