移动端报表JS开发演示样例

近期对移动端的报表开发颇有研究，细磨精算了好久，尽管到如今还是”囊中羞涩”，但决定还是先抛砖引玉，拿点小干货出来和大家分享。

研究的工具是比較有代表性的FineReport。

1、 移动端哪些地方支持调用js

web事件	分页预览	填报预览
载入结束事件	√	X
填报成功事件	--	√

报表内部js	单元格	图表
超级链接js	√	√

控件事件	參数控件	填报控件	表单控件
初始化后事件	√	√	X
编辑前	√	√	X
编辑后	√	√	X
编辑结束	√	√	X
点击	√	√	X
状态改变	√	√	√

2、报表控件支持的脚本函数

函数名	函数描写叙述	填报控件	參数控件	表单控件
setEnable	设置控件的可用性	√	√	√
isEnable	推断控件是否可用	√	√	√
setVisible	设置控件的可见性	√	√	√
isVisible	推断控件的可见性	√	√	√
setValue	设置控件值	√	√	√
getValue	获取控件的值	√	√	√
setText	设置控件的显示值	√	√	√
getText	获取控件的显示值	√	√	√
reset	重置控件	√	√	√
fireEvent	触发指定名字的事件	√	√	√

3、报表控件支持的脚本函数

函数名	函数描写叙述	补充说明	实现
contentPane	当前报表对象	无	√
currentPageIndex	当前所在页	contentPane经常使用属性 仅仅有分页预览报表才有	√
reportTotalPage	总页数	contentPane经常使用属性 仅仅有分页预览报表才有	√
gotoFirstPage	首页	无	√
gotoPreviousPage	上一页	无	√
gotoNextPage	下一页	无	√
gotoLastPage	末页	无	√
gotoPage(n)	跳转到某一页	包括1个參数，表示跳转到第几页	√

4、 填报预览报表支持的脚本函数

函数名	函数描写叙述	补充说明	实现
contentPane	当前报表对象	无	√
verifyReport	数据校验	仅仅有填报表才干够用，contentPane经常用法	√
writeReport	提交报表	仅仅有填报表才干够用，contentPane经常用法	√
verifyAndWriteReport	数据校验后提交报表	仅仅有填报表才干够用，contentPane经常用法	√
curLGP	current logicpane	contentPane经常使用属性。仅仅有填报预览及表单预览下才有	√
getCellValue(cell)	获取指定格子的值	包括1个參数。单元格。仅仅有填报下有，curLGP经常用法	√
getCellValue(col, row)	获取指定格子的值	包括2个參数。列和行，仅仅有填报下有，curLGP经常用法	√
setCellValue(cell, null, value)	设置指定格子的值	包括3个參数，单元格。空和值，仅仅有填报下有，curLGP经常用法	√
setCellValue(col, row, value)	设置指定格子的值	包括3个參数。列，行和值，仅仅有填报下有，curLGP经常用法	√
getWidgetByCell	获取指定单元格中的控件	包括1个參数，单元格，contentPane经常用法	√
getWidgetByName	获取指定名字的控件	包括1个參数，控件名，contentPane经常用法	√
getWidgetsByName	获取指定名称的扩展控件，返回一个数组	包括1个參数，控件名。contentPane经常用法	√

5、经常使用的工具类脚本函数

函数名	函数描写叙述	补充说明	实现
FR.Msg.alert	弹出消息框函数	包括3个參数，分别表示：标题，内容，回调函数	√
FR.Msg.confirm	值确认弹出框函数	包括3个參数，分别表示：标题，值。回调函数	√
FR.Msg.prompt	可改动值的值确认弹出框函数	包括4个參数，分别表示：标题。说明，值，回调函数	√
FR.Msg.toast	在页面边缘出现的消息提示块，一小段时间后自己主动消失	包括1个參数。表示要提示的信息	√
FR.cjkEncode	进行cjk编码	包括1个參数，字符串	√
FR.cjkDecode	进行cjk解码	包括1个參数，字符串	√
FR.location	地理位置获取	包括一个回掉函数返回获取状态及信息	√
FR.doHyperlinkByGet /FR.doHyperlinkByPost	超级连接	包括2个參数。分别表示：超链的url。 传递的參数	√
FR.ajax	异步请求函数	/	√
_g().parameterCommit()	分页预览及填报预览自己主动查询	/	√
contentPane.setAppearRefresh()	页面再现的时候自己主动刷新	/	√

以上相应着报表的功能大致罗列了以下框架。以下先举一些小演示样例

获取控件的一系列方法

this.options.form.getWidgetByName("控件名");  //參数界面及表单中获取控件

contentPane.getWidgetByCell("单元格");  //填报界面获取控件

contentPane.getWidgetByName("控件名");   //填报界面获取控件

填报成功后刷新当前页

var url = "/WebReport/ReportServer?reportlet=js/shauxindangqian.cpt&op=write&__replaceview__=true";
FR.doHyperlinkByGet(url,{para:paravalue});  //刷新当前页面

js获取表单图表组件并刷新数据

var c=FR.Chart.WebUtils.getChart("chart0");
c.dataRefresh()；

延时函数

setTimeout(function() {  }, 500);

A超链至B填报，B提交数据后返回A时。A自己主动刷新显示新的数据

contentPane.setAppearRefresh();  //在A的载入结束后事件中加入js

以后会陆续分享一些移动端有用功能的应用实例啦，还有HTML5。