FusionCharts使用教程：Fusioncharts API參考方法(Functions)總結(jié)

---

chartType()FusionCharts的JavaScript類API提供了大量的功能。下面的列表顯示在每個(gè)功能的詳細(xì)信息：

一、FusionCharts的類 - 實(shí)例功能

1、configure(name:string , value:string)  or  configure(configurations: Object)

繪制圖表前，圖表配置設(shè)置。主要是，您可以使用此功能，使用此功能設(shè)置圖表消息或電網(wǎng)參數(shù)。的名稱的結(jié)構(gòu)和配置的值被作為參數(shù)傳遞。在右邊的第一個(gè)例子。您也可以通過配置對(duì)象的功能的集合。參數(shù)對(duì)象將包含名稱和值對(duì)配置名稱和相應(yīng)的值。在右邊的第二個(gè)例子。

myChart.configure("ChartNoDataText", "Please select a record above");

or

myChart.configure({ "ChartNoDataText" : "Please select a record above" , "InvalidXMLText" : "Please validate data" });

2、addVariable(name:string , value:string)

與configure方法一樣，此功能已經(jīng)過時(shí)了的。

myChart.addVariable("ChartNoDataText", "Please select a record above");

3、render(renderAt: String) or  render(renderAt: HTMLNode)

主要作用是將新建的圖表裝載到指定的某個(gè)DIV容器內(nèi)。

myChart.render("chartContainer");

or

myChart.render(document.getElementById ("chartContainer"));

4、setXMLUrl(Url: String)

設(shè)置圖表實(shí)例的XMLUrl參數(shù)，主要是用于動(dòng)態(tài)修改數(shù)據(jù)源xml的路徑。

myChart.setXMLUrl("mychartdata.xml");

5、setXMLData(XML: string)

主要是設(shè)置圖表對(duì)象XMLData，參數(shù)傳遞為拼接好的圖表字符串。

myChart.setXMLData("<chart><set value='100' /></chart>");

6、setJSONUrl(Url: String)

設(shè)置圖表對(duì)象JSONUrl參數(shù)。

myChart.setJSONUrl("myJSONStream.json");

7、setJSONData(JSON:Object)  or setJSONData(JSON:String)

動(dòng)態(tài)設(shè)置或者修改圖表對(duì)象的數(shù)據(jù)，格式為：Json格式的字符串。

myChart.setJSONData( {

"chart":{

"caption":"My Chart Caption"  

},  

"data":[

{  "value":"100" },

{  "value":"200" }

]

}

);

or

myChart.setJSONData('{"chart":{ "caption":"My Chart Caption" }, "data":[ {"value":"100" }, { "value":"200" } ] 

});

8、setChartDataUrl(Url:String, dataFormat: string)

當(dāng)我們的圖表數(shù)據(jù)是來自于一個(gè)頁面所產(chǎn)生的數(shù)據(jù)時(shí)，我們就可以用此方法。

參數(shù)說明：

Url：產(chǎn)生數(shù)據(jù)的頁面地址

dataFormat：產(chǎn)生數(shù)據(jù)的格式（xml、json)

myChart.setChartDataUrl("mydynamicdata.aspx", "json");

or

myChart.setChartDataUrl("mydynamicdata.aspx", "xml");

9、setChartData(dataSource: string, dataFormat: string)

設(shè)置或者修改圖表數(shù)據(jù)。這個(gè)函數(shù)有兩個(gè)參數(shù)。第一個(gè)是數(shù)據(jù)源中的數(shù)據(jù)。第二個(gè)是DATAFORMAT。數(shù)據(jù)源可以是XML源的URL，URL JSON源，XML字符串，JSON字符串和JSON對(duì)象。因此，正確識(shí)別的格式，數(shù)據(jù)格式作為第二個(gè)參數(shù)傳遞。

myChart.setChartData( "myxmldata.jsp" , "xmlurl");

or

myChart.setChartData( "<chart><set value='2310'/></chart>" , "xml");

or

myChart.setChartData( "myjsondata.php" , "jsonurl");

or

myChart.setChartData( "{ chart : {}, data :[{ value : 100 }] }" , "json");

or

myChart.setChartData( { chart : {}, data :[{ value : 100 }] } , "json");

10、setDataURL(Url:string)

利用此功能可以在設(shè)置或更新圖表圖表URL的XML數(shù)據(jù)。這個(gè)函數(shù)接受一個(gè)URL字符串。

myChart.setDataURL( "myxmlsource.xml" );

11、setDataXML(dataSource: string)

利用此功能可以在設(shè)置或更新圖表XML數(shù)據(jù)的字符串。

myChart.setDataXML( "<chart><set value='213' /></chart>");

12、SetTransparent ( isTransparent: boolean )

使圖表背景成為透明的。您將需要設(shè)置bgAlpha，canvasBgAlpha等屬性的<chart>元素來完成的透明度。該函數(shù)接受一個(gè)布爾參數(shù)。只有為true的時(shí)候，背景圖才會(huì)產(chǎn)生透明效果。

myChart.setDataXML( "<chartbgAlpha='0,0'><set value='213' /></chart>");

myChart.setTransparent(true);

13、getChartData(dataFormat:string)

這個(gè)函數(shù)返回圖元數(shù)據(jù)格式的數(shù)據(jù)作為參數(shù)提供。當(dāng)傳遞XML作為數(shù)據(jù)格式，它提供了XML數(shù)據(jù)的字符串。 ，當(dāng)JSON是通過為數(shù)據(jù)格式，數(shù)據(jù)被返回的JSON對(duì)象。

var myXML = FusionCharts("myChartId").getChartData( "xml");

var myJSONObj = FusionCharts("myChartId").getChartData( "json" );

14、getXMLData()

獲取圖表的XML數(shù)據(jù)串。

var myXML = FusionCharts("myChartId").getXMLData();

15、getJSONData()

獲取圖表數(shù)據(jù)的Json對(duì)象。

var myJSONObj = FusionCharts("myChartId").getJSONData();

16、getDataAsCSV()

CSV字符串返回?cái)?shù)據(jù)的圖表。輸出CSV字符串，可以使用XML參數(shù)配置。 String，表示CSV格式數(shù)據(jù)的圖表。

var strCSV = FusionCharts("myChartId").getDataAsCSV();

17、getXML()

獲取圖表數(shù)據(jù)的XML

var myXML = FusionCharts("myChartId").getXML();

18、getChartAttribute()

返回的屬性值中指定的圖表XML節(jié)點(diǎn)或“圖表”屬性的JSON數(shù)據(jù)。如果屬性是空的，那就是沒有找到其XML或者Json數(shù)據(jù)。

//獲取圖表的標(biāo)題

var caption = FusionCharts("myChartId").getChartAttribute( "caption");

19、setChartAttribute(name:string, value:string) or  setChartAttribute(AttributeCollection:Object)

設(shè)置圖表屬性的新值更新圖表。它有兩個(gè)參數(shù)。的屬性的名稱和參數(shù)值。顧名思義圖表的根屬性（也被稱為“圖表屬性”，這是通過<chart>元素在圖表的XML數(shù)據(jù)或圖表的JSON數(shù)據(jù)通過圖表財(cái)產(chǎn)）。您還可以通過將它們作為一個(gè)對(duì)象的屬性名和值對(duì)的集合功能。在右邊的第二個(gè)例子。一旦圖表屬性得到改變，drawcomplete的的事件被觸發(fā)。

myChart.setChartAttribute ( "caption" , "Latest sales report" );
or
chartReference.setChartAttribute( { "palette" : "2", paletteColors : "ACBF72", useRoundEdges : 1 } );

20、configureLink(objConfiguration: Object, level:Number)  or configureLink(arrConfiguration: Array)

通過此功能，您可以將所有您想要的的LinkedCharts配置。您可以通過一個(gè)FusionCharts的構(gòu)造函數(shù)接受的所有的屬性。這些圖表屬性將被應(yīng)用的LinkedCharts。如果沒有提供，LinkedCharts將繼承屬性從父圖表。
 此外，您還可以配置的疊加按鈕，使用overlayButton財(cái)產(chǎn)。這些設(shè)置還可以去另一個(gè)對(duì)象。configureLink函數(shù)可以接受兩種格式的參數(shù)：作為兩個(gè)獨(dú)立的參數(shù)，第一個(gè)參數(shù)是一個(gè)對(duì)象，其中包含的所有配置（圖疊加按鈕）。第二個(gè)參數(shù)接受一個(gè)數(shù)字表示所配置的水平。第一向下鉆取級(jí)別為0（零）。請(qǐng)參閱例如，在頂部的右側(cè)。作為一個(gè)單一的二維索引數(shù)組，每個(gè)元素是一個(gè)對(duì)象，它包含所有的圖表和覆蓋按鈕的相關(guān)配置。每個(gè)向下鉆取級(jí)別由第一級(jí)是0（零）的陣列，其中的索引表示。所以，在一個(gè)特定的數(shù)組索引“對(duì)象實(shí)際上等于陣列的索引號(hào)的電平數(shù)字，這是適用于這些設(shè)置。請(qǐng)參閱例如，在右邊的底部。

myChart.configureLink(
{
swfUrl: 'Charts/Bar2D.swf',
width: '30%',
overlayButton:
{
message: ' x ',
bgColor:'999999',
borderColor: 'cccccc'
}
},
0);
or
myChart.configureLink(
[ {swfUrl: 'Charts/Bar2D.swf'},
{swfUrl: 'Charts/Pie2D.swf'},
{swfUrl: 'Charts/Line2D.swf'},
{swfUrl: 'Charts/Area2D.swf'}
]
);

21、resizeTo(width:String, height:String)

此功能調(diào)整現(xiàn)有的圖表。你可以通過寬度和高度值的百分比或像素值（沒有PX后綴）。一旦被調(diào)整大小調(diào)整大小（FC_Resized）圖表中，drawcomplete事件被觸發(fā)。

myChart.resizeTo( "500", "400" )
or
myChart.resizeTo( "80%", "100%" )

22、exportChart( exportSettings: Object)

調(diào)用圖表保存為PDF /圖片。

myChart.exportChart( { exportFormat : 'jpg'} )
or
myChart.exportChart( { exportAtClient: '1', exportFormat: 'PDF' } );

23、print()

打印圖表

FusionCharts("myChartId").print()

24、clone( [chartParams: Object] )

該功能可讓您復(fù)制一個(gè)FusionCharts的JavaScript對(duì)象和使用它的設(shè)置來創(chuàng)建另一個(gè)圖表。該功能可以選擇一個(gè)對(duì)象作為參數(shù)。對(duì)象可以包含圖表設(shè)置之前，它被克隆，這將覆蓋現(xiàn)有的源圖的設(shè)置。該函數(shù)返回的FusionCharts JavaScript對(duì)的一個(gè)實(shí)例。

var newChart = myChart.clone();
or
var newChart = myChart.clone( { swfUrl : 'Area2D.swf' } );

25、dispose()

刪除、清除某個(gè)圖表實(shí)例。此外，該函數(shù)將配合BeforeDispose事件，以消除圖表和處理后的圖表已被刪除。

FusionCharts("myChartId").dispose();

26、chartType()

這個(gè)函數(shù)返回的圖表類型或圖表所呈現(xiàn)的FusionCharts的JavaScript對(duì)象的別名。請(qǐng)注意，別名的值是依賴于圖表SWF文件名。

var strCharType = FusionCharts("myChartId").chartType();

27、isActive()

此功能檢查是否FusionCharts的SWF是可見的和激活的。返回true或false。

var strCharType = FusionCharts("myChartId").isActive();

28、hasRendered()

這個(gè)函數(shù)返回布爾值，指示是否已完成呈現(xiàn)的圖表。hasRendered（）已過時(shí)

var strCharType = FusionCharts("myChartId").hasRendered();

29、signature()

它返回一個(gè)字符串，代表的簽名圖。 FusionCharts的XT服務(wù)發(fā)布4個(gè)圖表，它是“FusionCharts/3.2.2（XT）SR4”

var strCharType = FusionCharts("myChartId").signature();