FusionCharts Link format

FusionMaps XT provides the option to turn each entity, marker, connector or the whole map as a hot-spot that be clicked on for drill-down. An entity, marker or connector is set as hot-spot by setting link attribute for that entity in map data. A full map is set as a hot-spot using clickURL of map data-source. Additionally, you can set a link for about menu item using aboutMenuItemLink attribute. You can also set a link to the branding logo using logoLink attribute.

The syntax of the hot-spot links follow a specific format which is termed as FusionCharts Link Format. In most cases, the syntax can be identified as two or more sections separated by a dash (-). The left most section generally specifies the type of the link followed by other required parameters. The formats can be listed as follows:

Link type Prefix Syntax What it does Example
Simple none URL Opens the URL in the same window where the map is rendered. It replaces the page containing the map. The URL can be absolute or relative to the page containing the map. Read More » link="http://www.fusioncharts.com"
New window N- N-url Opens the URL in a new browser window. To use this feature, you need to disable any pop-up blockers in the browser. The URL can be absolute or relative to the page containing the map. Read More » link="N-../detailedChart.aspx"
Frame F- F-FrameName-url Opens the URL in a frame or an iframe. The name of the frame is passed as the first parameter after the prefix followed by the URL to open. The URL can be absolute or relative to the page containing the map. Read More » link="F-detailsFrame-DemoLink1.html"
Popup P- P-nameOfWindow,Popup settings-url Opens link in a configurable popup window. The first parameter after the prefix P- is the name of the popup window. This is followed by comma separated list of attributes for the new window. The last parameter is the URL. The URL can be absolute or relative to the page containing the map. Read More » link="P-detailsWin,width=400, height=300, toolbar=no, scrollbars=no, resizable=no-ShowDetails.asp"
JavaScript JavaScript: JavaScript:JavaScript statement Any JavaScript statement or function call can be passed as  a parameter, which is then executed when the link is clicked. Read More » link="JavaScript:myJSFunction('USA', 235);"
JavaScript J- J-JavaScriptFunctionName-parameters A single JavaScript function is called using this link type. The name of the JavaScript function is followed by the prefix J-. The function will be passed a single string parameter, which comes after the function name. Read More »

link="j-myJSFunction-China, 90"
LinkedCharts newchart- newchart:mapSWFname-dataformat-datasource This link invokes and creates LinkedCharts. Parameters passed through this format are:
  • The first parameter after newchart: prefix is the chart/ map SWF filename (without path) or chart/ map alias.
  • The chart/map is followed by a - and then comes the data-format of the LinkedChart data. It can be xml, json, xmlurl or jsonurl. This is followed by another - and the final parameter
  • The final parameter specific the URL or id of the data-source as per the data-format.   Read More »
 link="newchart:FCMap_NorthAmerica.swf-xmlurl-quarterly2005.xml"

or

link="newchart:Australia-xml-2004quarterly"

or

link="newchart:Africa-jsonurl-2005.json"

or

link="newchart:FCMap_California.swf-json-2006Data"


Note: Internally the map decodes a URL that you set as link. Before invoking the link it again encodes the URL. If you are passing multilingual characters via a URL or do not want this decode-encode mechanism to be handled by the map you can set unescapeLinks='0' in <map> element of the map's XML data. If you are using JSON data, you need to use { "map" : { "unescapeLinks" : "0" ... } ... } .