首页 FusionCharts图表控件中文版使用手册

FusionCharts图表控件中文版使用手册

举报
开通vip

FusionCharts图表控件中文版使用手册FusionCharts图表控件中文版使用手册 目录 TOC \o "1-7" \h \z \u 前言、先谈谈我对fusionCharts的看法: 3 一、构成fusionCharts的三要素:swf、data.xml、承载图表的载体 3 二、对于我们还未使用的功能:图表转换成图片或者pdf导出、热点链接 3 三、重点 3 fusionCharts的基本知识部分: 4 一 、SWF 动画文件 4 二、XML数据文件 4 三、HTML(当然也可以使用JSP)嵌入charts文件 5 四、结合javascript 的应...

FusionCharts图表控件中文版使用手册
FusionCharts图表控件中文版使用手册 目录 TOC \o "1-7" \h \z \u 前言、先谈谈我对fusionCharts的看法: 3 一、构成fusionCharts的三要素:swf、data.xml、承载图表的载体 3 二、对于我们还未使用的功能:图表转换成图片或者pdf导出、热点链接 3 三、重点 3 fusionCharts的基本知识部分: 4 一 、SWF 动画文件 4 二、XML数据文件 4 三、HTML(当然也可以使用JSP)嵌入charts文件 5 四、结合javascript 的应用: 5 五、热点链接:link=’ ’ 5 六、图表数据导出 6 七、图表导出为pdf或者图片(JPEG和PNG)形式 6 八、中文编码解决方法: 7 附注fusionCharts详细属性: 7 1、边框及整个背景的属性: 7 2、图表背景属性: 8 3、外部引入LOGO: 8 4、图表名称和轴属性: 9 5、data plot属性 9 6、数据横纵轴属性 9 7、图表上的数据显示 10 8、图表调色板 10 9、横轴坐标最大值、最小值属性 10 10、图表内部的div线相关属性 10 11、图表内部垂直div线的相关属性 10 12、Zero plan相关属性 11 13、Anchors相关属性(针对线图) 11 14、tool-tip 属性 11 15、padding属性 11 16、数据格式相关属性 12 17、legend相关属性 12 18、3D图表属性 12 19、自定义菜单属性 13 20、趋势线: 13 21、Styles属性:(eg)定义自定义效果属性,然后在一个对象上进行使用。 13 按照编程xml构造结构分:(只列举出了几种主要属性,主要用于xmlBuiler) 16 前言 ​ 先谈谈我对fusionCharts的看法: 一、构成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文件以 开头,以结束;或者以开头,以结束 2.​ 属性:(详细见附注)XML标签属性有以下四种数据类型:布尔型、数字型、字符型、十六进制颜色代码(只支持十六进制的颜色表示,且去掉前面的#号) 3.​ 注意点: 1)​ 当数字前缀numberPrefix为€、£、₣、¥、¢、%使用dataURL时可直接使用,但是当使用dataXML时需进行相应的编码即%E2%82%AC、%A3、%E2%82%A3、%A5、%A2、%25。 2)​ 当标题caption含有&在dataXML中要被编码为%26。 3)​ Fusioncharts不支持<、>号,需编码成<、> 4)​ 当需要显示“’”时(eg: John’s)使用dataURL时需被编译成'使用dataXML时需被编译成%26apos; 5)​ 当数据不连续时可以使用connectNullData属性设置是否让其连续显示(不连续点的直接用直线相连,也可以再不连续点的前一属性中设置dashed='1'可以用虚线链接不连续点) 三、HTML(当然也可以使用JSP)嵌入charts文件 1、不使用JS情况:(不推荐使用) 使用嵌入swf文件,并设置&dataUrl=data.xml的路径 2、使用JS情况:(推荐使用这种方法嵌入Charts文件) 1)​ 必须包含fusioncharts.js文件 2)​ new FusionCharts(“swf”,”id”,”width”,”height”,”debugmodel”,”registerwithjs”)创建一个fusioncharts对象 3)​ 用这个对象的setDataURL方法包含data.xml文件或者用这个对象的setDataXML方法包含数据源的xml字符串 四、结合javascript 的应用: 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:string):返回xml 标记的属性 6)​ hasRendered():布尔型,标志图表是否已经呈现成功 7)​ getDataAsCSV():返回图表的数据位CSV字符型 8)​ 关于3D图表方面的方法在后面的属性里面有讲 五、热点链接:link=’ ’ 四种链接方式: 1.​ 链接到同一个窗口:link='指定页面%3F参数' 2.​ 链接到新的窗口:link='n-指定页面%3F参数' 3.​ 链接到一个指定的frame:link='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 :link="j-function()" 7.​ Click 事件处理:link='S-parameter'(此方法是整个图表的链接情况) 六、图表数据导出 1.​ 使用context menu:设置属性showExportDataMenuItem='1',并可以通过exportDataMenuItemLabel=” ”设置导出标签的名称。这样就可以把图表中的数据复制到剪贴板上了,然后打开记事本之类的东东就可以把数据粘贴到上面去了。 2.​ 使用JavaScript Menu:首先置registerWithJS为1,即var chart1 = new FusionCharts("../../FusionCharts/Column3D.swf", "chart1Id", "400", "300", "0", "1")。然后根据charts节点id获得一个对象,使用var chartObj = getChartFromId("chart1Id")方法。最后从这个对象取出图表里的数据,使用chartObj.getDataAsCSV( ),然后就可以进行你需要的处理了 七、图表导出为pdf或者图片(JPEG和PNG)形式 1、服务器端图表导出 1)​ 把jar包Builderpath到web app libraries下面 2)​ 把classes文件发布到web-info下面 3)​ 在data.xml文件里加入exportEnabled='1'(允许导出)、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='1'(允许导出) exportAtClient='1' (客户端导出方式)exportHandler='fcExporter1'(处理导出) 4)​ Html文件里加入
FusionCharts Export Handler Component
3、批图表导出处理: 1)​ 前提:要批导出的数据共用一个xml文件,即共用数据。 2)​ 与单个导出的不同之处: ​ myExportComponent.sourceCharts = ['myChartId1','myChartId2','myChartId3']; ​ 用sourceCharts方法包含需导出的所以图表DOMid ​ 设置导出图片相关的属性:componentAttributes。 八、中文编码解决方法: 提供字符串数据源的页面必须硬编码才行,可以是GBK或UTF-8。 1、动态产生的XML文档,即使用dataURL方法加载的数据,编码须是GBK或者gb2312。做法:只需在包含数据源的jsp页面加入<%@ page language="java" contentType="text/xml; charset=GBK"%> 2、提供字符串数据源(即使用dataXML方法加载的数据)的页面必须硬编码才行,可以是GBK或UTF-8。做法:只需在包含xml的jsp页面加入<%@ page language="java" contentType="text/html; charset=UTF-8"%> 附注fusionCharts详细属性: 按照模块分类: 1、边框及整个背景的属性: 属性名称 属性说明 示例或说明 bgColor 背景颜色 bgColor='999999,FFFFF渐变 bgColor=’999999’ 单色 bgAlpha 背景透明度 设置范围在1-100 showBorder 图表外是否显示边框 默认二维图表显示,三维不显示 borderColor 边框颜色 十六进制表示去掉前面的#号 borderThickness 边框线的粗细 像素表示 borderAlpha 边框透明度 bgSWF 背景图片或动画 保证此图片和SWF文件在同一个文件夹 bgSWFAlpha 设置背景图片的透明度 2、图表背景属性: 属性名称 属性说明 示例或说明 canvasbgColor 图表背景颜色 可设置单色也可以使用梯度设置渐变色 canvasbgAlpha 图表背景透明度 canvasBorderColor 图表背景边框颜色 canvasBorderThickness 图表背景边框线粗细 canvasBorderAlpha 图表背景边框透明度 3、外部引入LOGO: 属性名称 属性说明 示例或说明 logoURL LOGO引入的地址 logoURL='logo_fc.gif' logoPosition LOGO在图表中的位置 TL – 左上TR – 右上BL – 左下BR – 右下CC – 中间 logoAlpha LOGO的透明度 logoScale LOGO比例 4、图表名称和轴属性: 属性名称 属性说明 示例或说明 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、data plot属性 plotGradientColor 取消梯度颜色 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、Zero plan相关属性 zeroPlaneColor 设置零线(面)的颜色 zeroPlaneThickness 设置零线(面)的粗细 zeroPlaneAlpha 设置零线(面)的透明度 zeroPlaneShowBorder 是否显示零面的外框 只针对3D图表 zeroPlaneBorderColor 设置零面外框的颜色 只针对3D图表 13、Anchors相关属性(针对线图) drawAnchors 是否显示线图的Anchors 默认显示 anchorSides 设置Anchors是几边形 3-20 anchorRadius 设置Anchors的大小 anchorBorderColor 设置Anchors外框颜色 anchorBorderThickness 设置Anchors外框线条粗细 anchorBgColor 设置Anchors里面的颜色 anchorAlpha 设置Anchors整体的透明度 1-100 anchorBgAlpha 设置Anchors所处背景的透明度 1-100 14、tool-tip 属性 showToolTip 鼠标放上去是否显示提示 Set属性里可自定义设置toolText toolText 自定义提示框显示的内容 toolTipBorderColor 提示框边框的颜色 toolTipBgColor 提示框背景颜色 15、padding属性 chartLeftMargin 纵轴标题离外边框的距离 chartRightMargin Canvas右边线离外边框的距离 chartTopMargin 标题离外边框的距离 chartBottomMargin 横轴标题离外边框的距离 captionPadding Canvas上边线离图表标题的距离 xAxisNamePadding 横坐标离横轴标题的距离 yAxisNamePadding 纵坐标离纵轴标题的距离 yAxisValuesPadding Canvas左边线离纵坐标标签的距离 labelPadding Canvas下边线横坐标标签的距离 valuePadding 图表上面的数据里图表的距离 canvasPadding Canvas左边线离第一个Anchor的距离 只限于线图和块图 16、数据格式相关属性 decimals 设置小数点后面保留的位数 forceDecimals 是否强制保留小数点后面的decimals设置的位数 formatNumberScale 是否按默认的数据格式显示 decimalSeparator 小数点的分隔表示方式 默认‘.’ thousandSeparator 千分位的分隔表示方式 默认‘,’ numberScaleValue 两个联合一起使用,定义数据标度 numberScaleValue='1000,1000,1000' numberScaleUnit numberScaleUnit='K,M,B' numberPrefix 数字显示的前缀 numberPrefix='$' numberSuffix 数字显示的后缀 17、legend相关属性 showLegend 是否显示图例说明 默认显示 legendPosition 设置图例说明的位置 legendBgColor 设置图例说明的背景颜色 legendBgAlpha 设置图例说明的背景透明度 legendBorderColor 设置图例说明的边框颜色 legendBorderThickness 设置图例说明的边框粗细 legendBorderAlpha 设置图例说明的边框透明度 legendShadow 是否显示为图例说明显示阴影 legendScrollBgColor 设置图例说明滚动条的背景颜色 当图例说明中有很多事件时 legendScrollBarColor 设置图例说明滚动条的颜色 当图例说明中有很多事件时 egendScrollBtnColor 设置图例说明滚动条的按钮的颜色 当图例说明中有很多事件时 18、3D图表属性 view2D() 以二维的形式显示 3D图表已有的方法接口 view3D() 以三维的形式显示 3D图表已有的方法接口 resetView() 重置,恢复到原先的角度 3D图表已有的方法接口 rotateView(x,y) 旋转到所选的角度 3D图表已有的方法接口 getViewAngles() 获得当前图表所处的横纵角度 var a=getViewAngles(); alert(a.xAng); alert(a.yAng); cameraAngX 设置图表角度(横轴角度) 0 to 360/0 to -360默认为30度 cameraAngY 设置图表角度(纵轴角度) 0 to 360/0 to -360默认为-45度 startAngX 设置图表开始的角度(横轴角度) 0 to 360/0 to -360 endAngX 设置图表结束的角度(横轴角度) 0 to 360/0 to -360 startAngY 设置图表开始的角度(纵轴角度) 0 to 360/0 to -360 endAngY 设置图表结束的角度(纵轴角度) 0 to 360/0 to -360 dynamicShading 是否设置光源影响 lightAngX 设置光源的角度(横轴角度) 0 to 360/0 to -360 lightAngY 设置光源的角度(纵轴角度) 0 to 360/0 to -360 YZWallDepth 设置yz面的深度 ZXWallDepth 设置zx面的深度 XYWallDepth 设置xy面的深度 clustered 图表是否嵌入显示 默认前后重叠显示 19、自定义菜单属性 showAboutMenuItem 是否显示自定义菜单 默认显示 aboutMenuItemLabel 设置自定义菜单的名称 aboutMenuItemLabel ='About My Company' aboutMenuItemLink 设置自定义菜单的链接 aboutMenuItemLink='n-http://www.youshang.com 20、趋势线: dashed 是否虚线显示 默认实线显示 dashLen 设置虚线长度 dashGap 设置虚线间隙宽度 startValue 起始值 单个时一条横线,有结束值时,两点连线 endValue 结束值 displayvalue 线标示 valueOnRight 设置displayvalue显示右边 valueOnRight ='1' color 设置线颜色 21、Styles属性:(eg)定义自定义效果属性,然后在一个对象上进行使用。 1、定义一个styles。部分定义。基本属性有name(给type所定义的style取的名字)、type(FusionCharts 只支持下面六种styles: Font(字体)、Animation(动画)、Shadow(阴影)、Glow(轮廓线)、Blur(模糊化)、Bevel(产生透视,增强立体感))。 2、作用于一个对象。< application>定义。 3、对应关系 作用对象 对象说明 可以应用的style属性 Animation Parameters Supported BACKGROUND 图表所处的整个背景 Animation Shadow Glow Bevel Blur _alpha _x _y _xScale _yScale CANVAS 单指图表填充的位置 Animation Shadow Glow Bevel Blur _alpha _x _y _xScale _yScale CAPTION 图表的标题 Animation Font Shadow Glow Bevel Blur _alpha _x _y DATALABELS 图表X轴标签名称 Animation Font Shadow Glow Bevel Blur _alpha _x _y DATAPLOT 组成图表的数据块 Animation Shadow Glow Bevel Blur _alpha _x _y _xScale _yScale DATAVALUES 图表的数据 Animation Font Shadow Glow Bevel Blur _alpha _x _y DIVLINES 图表背景水平或者垂直的div线 Animation Shadow Glow Bevel Blur _alpha _y _yScale HGRID 连续的div线之间的颜色块 Animation Shadow Glow Bevel Blur _alpha _y _xScale _yScale SUBCAPTION 图表的二级标题 Animation Font Shadow Glow Bevel Blur _alpha _x _y TOOLTIP 当鼠标点在图标上时出现的提示框 Font TRENDLINES 趋势线 Animation Shadow Glow Bevel Blur _alpha _y _xScale _yScale TRENDVALUES 趋势线的值 Animation Font Shadow Glow Bevel Blur _alpha _x _y VLINES 垂直分隔线 Animation Shadow Glow Bevel Blur _alpha _x _y _yScale XAXISNAME X轴的名称 Animation Font Shadow Glow Bevel Blur _alpha _x _y YAXISNAME Y轴名称 Animation Font Shadow Glow Bevel Blur _alpha _x _y YAXISVALUES Y轴数据标度 Animation Font Shadow Glow Bevel Blur _alpha _x _y _rotation