FusionCharts图表控件中文版使用手册Word格式文档下载.docx
《FusionCharts图表控件中文版使用手册Word格式文档下载.docx》由会员分享，可在线阅读，更多相关《FusionCharts图表控件中文版使用手册Word格式文档下载.docx（24页珍藏版）》请在冰豆网上搜索。
前言
Ø
先谈谈我对fusionCharts的看法：
swf、data.xml、承载图表的载体
1、Swf：
按照你所设计的图表类型加载相应的.swf文件到你的工程即可（eg：
若你想生成一张二维柱状图，那么在你的工程里就必须包含Column2D.swf文件）
2、Data.xml：
方法一：
直接用data.jsp文件替代data.xml文件，写法格式同xml。
图表所需的属性直接在里面写死就行，只是所需的横纵坐标的数据调用后台的方法从数据库里面取得。
这样就可以省去xmlBuilder这部分代码。
方法二：
从后台取数据，然后调用相应的xmlBuiler方法生成所需的xml。
项目中已有一些XmlBuilder的方法可供调用。
3、承载图表的载体：
HTML、JSP等都可以。
调用fusionCharts开发方提供的fusioncharts.js里面写的fusionchart方法设置相关的参数直接生产相应的图表，产生一个fusioncharts图表的div节点。
但是现在fusionCharts图表还不能直接嵌入到ext框架里面。
只能通过iframe嵌入。
这样每次刷新的时候都会从新载入。
图表转换成图片或者pdf导出、热点链接
1、图表转换成图片或者PDF导出：
fusionCharts开发方提供了两种方法实现，一种的客户端导出，一种是服务器端导出。
建议使用客户端导出，使用开发方提供的服务器端导出的jar包时在IE上会抛出异常，在火狐上图表一般能显示，但在控制器也会抛出异常。
开发方写的方法，有一些内部机制，没有完全理解。
用服务器端的方法，可以正常使用。
2、热点链接：
主要应该是数据传递问题。
一方面可以直接从data.xml文件里面的link属性设置你要传过来的参数，然后在你要连接的页面用get方法去获取。
另一方面可以直接调用后台的方法把xml文件里面的数据以js的形式直接导入到你要连接的页面。
三、重点
1、FusionCharts的三要素
2、xml各属性的应用
fusionCharts的基本知识部分：
一、SWF动画文件
1.SWF文件在目录FusionCharts_Site\Charts下
2.包括：
1）单一系列图表（9种）：
（数据格式结构可共用，即单一系列的任何一种图表都可以用其他单一系列的图表代替）二维柱状图、三维柱状图、二维饼图、三维饼图、二维线图、二维条形图、二维块图、二维圆环图、三维圆环图。
2）多序列图（6种）：
（主要用于比较，数据格式结构可共用）二维多序列柱状图、三维多序列柱状图、二维多序列线图、二维多序列块图、二维多序列条形图、三维多序列条形图。
3）堆栈图（6种）：
二维堆栈柱状图、三维堆栈柱状图、二维堆栈块图、二维堆栈条形图、三维堆栈条形图、二维堆栈多序列柱状图（除最后一个图，其他的图数据可共享）
4）联合系列（7种）：
（单一系列的图形可以联合使用，在一张图表中显示）
5）点分布图（2种）：
（主要用来描述事件发生的分布情况，数据格式结构可共用）点状图、气泡状图。
6）带滚动条系列（6种）：
多序列图（包括二维柱状图、二维线图、二维块图）、二维堆状柱状图、二维联合图、二维联合双Y轴图。
7）Grid形式（1种）：
SSGrid.swf用法同上，可以结合上面的图形，一起使用。
注意：
grid的形式只支持单一系列图表的数据。
二、XML数据文件
1.XML文件以<
chart>
开头，以<
/chart>
结束；
或者以<
graph>
/graph>
结束
2.属性：
（详细见附注）XML标签属性有以下四种数据类型：
布尔型、数字型、字符型、十六进制颜色代码（只支持十六进制的颜色表示，且去掉前面的#号）
3.注意点：
1）当数字前缀numberPrefix为€、£
、₣、¥
、¢
、%使用dataURL时可直接使用，但是当使用dataXML时需进行相应的编码即%E2%82%AC、%A3、%E2%82%A3、%A5、%A2、%25。
2）当标题caption含有&
在dataXML中要被编码为%26。
3）Fusioncharts不支持<
、>
号，需编码成&
lt;
、&
gt;
4）当需要显示“’”时（eg:
John’s）使用dataURL时需被编译成&
apos;
使用dataXML时需被编译成%26apos;
5）当数据不连续时可以使用connectNullData属性设置是否让其连续显示（不连续点的直接用直线相连，也可以再不连续点的前一属性中设置dashed='
1'
可以用虚线链接不连续点）
三、HTML（当然也可以使用JSP）嵌入charts文件
1、不使用JS情况：
（不推荐使用）
使用<
object>
和<
embed>
嵌入swf文件，并设置&
dataUrl=data.xml的路径
2、使用JS情况：
（推荐使用这种方法嵌入Charts文件）
1）必须包含fusioncharts.js文件
2）newFusionCharts（“swf”,”id”,”width”,”height”,”debugmodel”,”registerwithjs”）创建一个fusioncharts对象
3）用这个对象的setDataURL方法包含data.xml文件或者用这个对象的setDataXML方法包含数据源的xml字符串
1.前提：
置FusionCharts中的registerwithjs为1
2.事件：
1）FC_Loaded（DOMId）：
描述当SWF文件在客户端已经完成下载
2）FC_Rendered（DOMId）：
3）FC_DataRendered（DOMId）：
描述当图表数据已经下载到dataxml或者dataURL
4）FC_DataLoadError（DOMId）：
描述当从特定的URL下载数据发生错误
5）FC_NoDataToDisplay（DOMId）：
描述当下载的xml文件里没有可显示的数据
6）FC_DataXMLInvalid（DOMId）：
描述xml格式错误
3.方法
1）setDataXML（strDataXML:
string）:
改变图表的数据
2）setDataURL（strDataURL:
string）：
同上
3）print（）：
打印图表
4）getXML（）：
返回图表的xml数据
5）getChartAttribute（attrNamr:
返回xml<
标记的属性
6）hasRendered（）：
布尔型，标志图表是否已经呈现成功
7）getDataAsCSV（）：
返回图表的数据位CSV字符型
8）关于3D图表方面的方法在后面的属性里面有讲
link=’’
四种链接方式：
1.链接到同一个窗口：
link='
指定页面%3F参数'
2.链接到新的窗口：
n-指定页面%3F参数'
3.链接到一个指定的frame：
F-FrameName-指定页面%3F参数'
（注参数一般不能超过两个，当超过两个则必须追加为一个字符串用逗号分隔）
4.链接到一个弹出框：
link="
P-detailsWin,width=400,height=300,toolbar=no,scrollbars=no,resizable=no-ShowDetails.asp%3FMonth%3DJan"
5.整个图表链接：
clickURL='
指定路径'
6.链接到Js：
j-function（）"
7.Click事件处理：
S-parameter'
（此方法是整个图表的链接情况）
六、图表数据导出
1.使用contextmenu：
设置属性showExportDataMenuItem='
，并可以通过exportDataMenuItemLabel=””设置导出标签的名称。
这样就可以把图表中的数据复制到剪贴板上了，然后打开记事本之类的东东就可以把数据粘贴到上面去了。
2.使用JavaScriptMenu：
首先置registerWithJS为1，即varchart1=newFusionCharts（"
../../FusionCharts/Column3D.swf"
"
chart1Id"
400"
300"
0"
1"
）。
然后根据charts节点id获得一个对象，使用varchartObj=getChartFromId（"
）方法。
最后从这个对象取出图表里的数据，使用chartObj.getDataAsCSV（）,然后就可以进行你需要的处理了
七、图表导出为pdf或者图片（JPEG和PNG）形式
1、服务器端图表导出
1）把jar包Builderpath到webapplibraries下面
2）把classes文件发布到web-info下面
3）在data.xml文件里加入exportEnabled='
（允许导出）、exportHandler='
JSP/FCExporter.jsp'
（即处理导出的路径，注意：
默认是在跟data.xml在同一个跟目录下面）、还可以设置exportAction（选择导出的图片会到客户端作为下载还是直接保存到服务器）、exportAtClient（选择是选择客户端导出还是选择服务器端导出）等属性
4）把FCExporter.jsp、FCExporterError.jsp放在web工程下面（注意：
FCExporter.jsp里WEB_ROOT_PATH的路径，默认情况是Resources文件直接放在web工程下的，若将Resources文件放在其他文件包下面时注意修改WEB_ROOT_PATH路径
5）处理流程：
data.xml中指明exportHandler路径。
触发导出时转向exportHandler所指向的路径FCExporter.jsp，在FCExporter.jsp中调用FusionChartsExportHelper.class中的HttpServletRequest类将data.xml中的数据以流的形式传进来，将charts的宽度、高度、颜色、domid作为元数据传入。
并且根据选择是导出pdf还是图片导向resource下面的不同页面路径。
（导出时会遇到数据传入的数据为空的情况，推荐使用客户端图表导出的方法）
2、客户端图表导出
1）包含FusionChartsExportComponent.js文件
2）包含FCExporter.swf文件
3）设置xml文件里的一下属性：
exportEnabled='
（允许导出）exportAtClient='
（客户端导出方式）exportHandler='
fcExporter1'
（处理导出）
4）Html文件里加入
<
divid="
fcexpDiv"
align="
center"
>
FusionChartsExportHandlerComponent<
/div>
scripttype="
text/javascript"
VarmyExportComponent=newFusionChartsExportObject（"
fcExporter1"
../../FusionCharts/FCExporter.swf"
）;
myExportComponent.Render（"
/script>
3、批图表导出处理：
1）前提：
要批导出的数据共用一个xml文件，即共用数据。
2）与单个导出的不同之处：
myExportComponent.sourceCharts=['
myChartId1'
'
myChartId2'
myChartId3'
];
用sourceCharts方法包含需导出的所以图表DOMid
设置导出图片相关的属性：
componentAttributes。
提供字符串数据源的页面必须硬编码才行，可以是GBK或UTF-8。
1、动态产生的XML文档，即使用dataURL方法加载的数据，编码须是GBK或者gb2312。
做法：
只需在包含数据源的jsp页面加入<
%@pagelanguage="
java"
contentType="
text/xml;
charset=GBK"
%>
2、提供字符串数据源（即使用dataXML方法加载的数据）的页面必须硬编码才行，可以是GBK或UTF-8。
只需在包含xml的jsp页面加入<
text/html;
charset=UTF-8"
按照模块分类：
属性名称
属性说明
示例或说明
bgColor
背景颜色
bgColor='
999999,FFFFF渐变bgColor=’999999’单色
bgAlpha
背景透明度
设置范围在1-100
showBorder
图表外是否显示边框
默认二维图表显示，三维不显示
borderColor
边框颜色
十六进制表示去掉前面的#号
borderThickness
边框线的粗细
像素表示
borderAlpha
边框透明度
bgSWF
背景图片或动画
保证此图片和SWF文件在同一个文件夹
bgSWFAlpha
设置背景图片的透明度
canvasbgColor
图表背景颜色
可设置单色也可以使用梯度设置渐变色
canvasbgAlpha
图表背景透明度
canvasBorderColor
图表背景边框颜色
canvasBorderThickness
图表背景边框线粗细
canvasBorderAlpha
图表背景边框透明度
logoURL
LOGO引入的地址
logoURL='
logo_fc.gif'
logoPosition
LOGO在图表中的位置
TL–左上TR–右上BL–左下BR–右下CC–中间
logoAlpha
LOGO的透明度
logoScale
LOGO比例
caption
标题
subcaption
子标题
xAxisName
X轴名称
yAxisName
Y轴名称
rotateYAxisName
Y轴名称是否旋转的显示
rotateNames
X轴名称是否旋转的显示
slantLabels=’1’时，斜45度，否则斜90度竖排
outCnvbaseFont
Canvas外面的字体
即标题、子标题、X/Y轴名称字体
outCnvbaseFontSize
Canvas外面的字体大小
范围在0-72
outCnvbaseFontColor
Canvas外面的字体颜色
baseFont
Canvas里面的字体
baseFontSize
Canvas里面的字体大小
baseFontColor
Canvas里面的字体颜色
5、dataplot属性
plotGradientColor
取消梯度颜色
plotGradientColor='
'
指明渐变是明度还是灰度（默认为明度，即加白色渐变）
333333'
showPlotBorder
是否显示数据块的边框
柱状图是否显示外框
plotBorderDashed
数据块的边框是否虚线显示
useRoundEdges
对于柱状图是否使用圆角
并且加入了glass效果
plotFillAngle
使用梯度颜色时，选择梯度角度
plotFillAlpha
使用梯度颜色时，选择透明度
6、数据横纵轴属性
showLabels
是否显示X轴标签名称
默认显示
showYAxisValues
是否显示Y轴标签名称
numberPrefix
Y轴数据加上前缀
如numberPrefix=‘a’
numberSuffix
Y轴数据加上后缀
如numberPrefix=‘b’
formatNumberScale
是否格式化数字,默认为1（True）,自动的给你的数字加上K（千）或M（百万）；
若取0,则不加K或M
formatNumberScale=’0’即可去除掉这个’k’
labelDisplay
标签显示格式
WRAP（重叠）ROTATE（旋转）Stagger（交错）
slantLabels
标签旋转显示时的倾斜角度
staggerLines
标签交错显示时的交错行数
labelStep
横轴标签隔几个显示
yAxisValuesStep
纵轴标签隔几个显示
7、图表上的数据显示
showValues
是否显示图表上的数据
displayValue
自定义图表上显示的内容
rotateValues
是否旋转90度显示图表上的数据
placeValuesInside
是否在图表内部显示数据
8、图表调色板
palette
图表块框框的渐变程度
1-5可供选择
paletteColors
图表块里面的渐变颜色
paletteColors='
FF5904,0372AB,FF0000'
9、横轴坐标最大值、最小值属性
yAxisMinValue
Y轴坐标的最小值
yAxisMaxValue
Y轴坐标的最大值
xAxisMinValue
X轴坐标的最小值
xAxisMaxValue
X轴坐标的最大值
10、图表内部的div线相关属性
divLineColor
设置div的颜色
divLineThickness
设置div的线条粗细
1-5
divLineAlpha
设置div的线条透明度
1-100
divLineIsDashed
设置div是否虚线显示
showAlternateHGridColor
设置div块是否高亮显示
11、图表内部垂直div线的相关属性
vDivLineColor
设置垂直div的颜色
vDivLineThickness
设置垂直div的线条粗细
vDivLineAlpha
设置垂直div的线条透明度
vDivLineIsDashed
设置垂直div是否虚线显示
showAlternateVGridColor
设置垂直div块是否高亮显示
alternateVGridAlpha（透明度）
alternateVGridColor（颜色）
12、Zeroplan相关属性
zeroPlaneColor
设置零线（面）的颜色
zeroPlaneThickness
设置零线（面）的粗细
zeroPlaneAlpha
设置零线（面）的透明度
zeroPlaneShowBorder
是否显示零面的外框
只针对3D图表
zeroPlaneBorderColor
设置零面外框的颜色
13、Anchors相关属性（针对线图）
drawAnchors
是否显示线图的Anchors
anchorSides
设置Anchors是几边形
3-20
anchorRadius
设置Anchors的大小
anchorBorderColor
设置Anchors外框颜色
anchorBorderThickness
设置Anchors外框线条粗细
anchorBgColor
设置Anchors里面的颜色
anchorAlpha
设置Anchors整体的透明度
anchorBgAlpha
设置Anchors所处背景的透明度
14、tool-tip属性
showToolTip
鼠标放上去是否显示提示
Set属性里可自定义设置toolText
toolText
自定义提示框显示的内容
toolTipBorderColor
提示框边框的颜色
toolTipBgColor
提示框背景颜色
15、padding属性
chartLeftMargin
纵轴标题离外边框的距离
chartRightMargin
Canvas右边线离外边框的距离
chartTopMargin
标题离外边框的距离
chartBottomMargin
横轴标题离外边框的距离
captionPadding
Canvas上边线离图表标题的距离
xAxisNamePadding
横坐标离横轴标题的距离
yAxisNamePadding
纵坐标离纵轴标题的距离
yAxisValuesPadding
Canvas左边线离纵坐标标签的距离
labelPadding
Canvas下边线横坐标标签的距离
升级会员 