《FineReport报表工具内置JS的使用》由会员分享，可在线阅读，更多相关《FineReport报表工具内置JS的使用（56页珍藏版）》请在金锄头文库上搜索。
1、FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： FineReport 报表工具报表工具内置内置 JS 的使用的使用 JavaScript 概述概述 JavaScript 是种脚本语言， 它可以用来制作与网络无关的， 与用户交互作用的复杂软件。 它是一种基于对象（Object Based）和事件驱动（Event Driver）的编程语言。 JavaScript 是动态的，它可以直接对用户或客户输入做出响应，A 无须经过 Web 服务程序。它对用户 的反映响应，是采用以事件驱动的方式进行的。所谓事件驱动，就是指在主
2、页(Home Page) 中执行了某种操作所产生的动作，就称为“事件”(Event)。比如按下鼠标、移动窗口、选择菜 单等都可以视为事件。当事件发生后，可能会引起相应的事件响应。 JavaScript 是依赖于浏览器本身，与操作环境无关，只要能运行浏览器的计算机，并支持 JavaScript 的浏览器就可正确执行。即 JavaScript 源代码在发往客户端执行之前不需经过编 译，而是将文本格式的字符代码发送给客户编由浏览器直接解释执行。 本章介绍了 FineReport 内置的 JavaScript 函数及其用法。 触发事件触发事件 控件的事件控件的事件 在控件设置的事件编辑中，事件编辑共有
3、七种触发事件：编辑前、编辑后、编辑结束、 点击、初始化后、状态改变及回调。 其中编辑前、编辑结束只在表单填报时起作用。 编辑后、点击、初始化后、状态改变等在表单填报及参数界面上都可以使用。 1. 编辑前编辑前 该事件是在填报时进入编辑状态后被触发 简单例子 1.1 新建一张空白报表，然后设计成如下格式 1.2 设置报表填报属性，在此不做赘述，具体设置方法可参考填报专题相关章节 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 1.3 定义单元格填报属性 将 B2 单元格控件类型设置为文本，并在 B2 控件中添加编
4、辑前事件，在 function fun()函数中添加一段 JS 代码： alert(alert(事件编辑前触发事件编辑前触发);); 如下图所示 1.4 保存并填报 点击设计器中的填报预览，进入填报的编辑状态，效果如下 此时当光标移至姓名单元格进行编辑时，编辑前事件被触发。 2. 编辑后编辑后 该事件在表单填报及参数界面上都可以被触发。 对于文本、 数字控件， 当输入任何字母或文字标点后触发； 对于下拉框， 复选框等控件， 当选择下拉选项后被触发，具体设置方法类似于编辑前事件，在这不再赘述。 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240
5、 商务咨询邮箱： 公司网址： 3. 编辑结束编辑结束 该事件只有在填报确认单元格输入内容如键盘输入回车后才能被触发 具体设置方法类似于编辑前事件，在这不再赘述。 4. 点击点击 该事件是在点击按钮，或点击下拉框、下拉树、下拉复选框等之后被触发 简单例子 4.1 新建报表 4.2 使用默认的参数界面，如图 4.3 控件设置 右击按钮控件， 选择控件设置控件设置， 打开控件设置面板， 添加点击事件， 在 function fun() 函数中添加一段 JS 代码: alert(alert(点击我就点击我就触发触发该事件啦该事件啦！);); 如下图所示 4.4 保存并预览 点击设计器中的分页预览，点击
6、查询按钮，此时点击事件被触发，如下图 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 5. 初始化后初始化后 该事件是按钮控件所特有，在点击分页预览或填报预览后初始化界面时被触发 简单例子 5.1 新建报表 5.2 使用默认的参数界面，如图 5.3 控件设置 右击按钮控件， 选择控件设置控件设置， 打开控件设置面板， 添加初始化后事件， 在 function fun()函数中添加一段 JS 代码: alert(alert(初始化后就触发该事件啦！初始化后就触发该事件啦！);); 如下图所示 FineReport
7、-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 5.4 保存并预览 点击设计器中的分页预览，就可以看见如下图所示效果 6. 状态改变状态改变 该事件为单选按钮、复选框组控件所特有，在其状态改变时被触发 简单例子 6.1 定义报表参数 p1，并设置其默认值为男 6.2 在参数界面上，定义参数 p1 的控件属性，如下图 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 6.3 添加事件 右击 p1 的控件， 选择控件设置控件设置， 打开控件设置面板， 添
8、加状态改变事件， 在 function fun()函数中添加一段 JS 代码: alert(alert(单选按单选按钮钮的状态改变啦！的状态改变啦！);); 如下图所示 6.4 保存并预览 点击设计器中的分页预览，单选按钮默认选中“男” ，当点击“女”时就会触发状 态改变事件，如下图 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 7. 回调回调 该事件为文件控件所特有，是在上传完文件之后触发该事件 简单例子 7.1 新建报表，定义文件控件，如下图： 7.2 添加事件 点击文件控件，打开控件设置面板，添加回调事
9、件，在 function fun()函数中添加 一段 JS 代码: alert(alert(回调事件触发啦！回调事件触发啦！);); 如下图所示 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 7.3 保存并预览 点击设计器中的填报预览，上传文件结束后，触发回调事件，如下图 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 其他事件其他事件 除了各控件中可以添加事件外，超级链接也可以引用 JavaScript,具体使用方法将在之后
10、的章 节中详述。同时在报表|报表 Web 属性及服务器|服务器配置中也可以添加各种 JS 事件，如 下图所示 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 超链接引用超链接引用 JavaScript 该例子实现用户在点击超级链接的时候，根据输入的页码，来决定链接到指定的页面。 有两种引用方式： 1.1. 将写好的方法保存为将写好的方法保存为 jsjs 文件，放置在工程下，在超级链接中直接调用文件，放置在工程下，在超级链接中直接调用 1.1 新建报表 1.2 模板设计 在 B3 单元格中写入公式：=range(
11、1,40)=range(1,40)，并将其扩张属性改为“从左到右扩展” ， 并将其设为居中，如下图所示： 1.3 添加超链接 右击 B3 单元格，选择超级链接，进入超级链接界面，点击添加 JavaScript, 如下图所示 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 写一段 Js 代码，内容为： function demo() var test = function() var num = parseInt(arguments0); contentPane.gotoPage(num); ; var valu
12、e = FR.Msg.prompt(输入, 页码, 2, test); 说明： var num = parseInt(arguments0); /获得输入框中输入的页码获得输入框中输入的页码 contentPane.gotoPage(num); /跳转到相应页码跳转到相应页码 var value = FR.Msg.prompt(输入, 页码, 2, test); /参数分别为对话参数分别为对话 框标题、对话框内容、输入框默认值、回调函数框标题、对话框内容、输入框默认值、回调函数 将此段内容保存为 test.js 文件 ，放在 WebReport 目录下，在超级链接界面 中插入该 test.js
13、，并在下面的 function fun()函数中调用demo();demo(); 效果如下图所示： FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 1.4 保存并预览 点击超级链接，出现如下图所示的输入提示对话框 在输入对话框中输入需要跳转的页数，并点击确定按钮，就跳转到相应的页面。 2.2. 直接在超级链接界面上写直接在超级链接界面上写 jsjs 方法方法 2.1 新建报表 2.2 模板设计 在 B3 单元格中写入公式：=range(1,40)=range(1,40)，并将其扩张属性改为“从左到右扩展” ，
14、并将其设为居中，如下图所示： FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 2.3 添加超链接 右击 B3 单元格，选择超级链接，进入超级链接界面，点击添加 JavaScript， 如下图所示 function fun()函数中写入如下 JS 语句： function test() var num = parseInt(arguments0); _g($sessionID).gotoPage(num); ; var value = FR.Msg.prompt(输入, 页码, 2,test); 说明： _g($
15、sessionID).gotoPage(num); /跳转到相应页码跳转到相应页码 如下图所示 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： 2.4 保存预览 点击超级链接，出现如下图所示的输入提示对话框 在输入对话框中输入需要跳转的页数，并点击确定按钮，就会跳转到相应的页面。 参数控件触发事件参数控件触发事件 参数控件的取值与置数参数控件的取值与置数 参数界面中， 最常见的就是获取参数的值进行运算或者将其作为另一个参数的判断依据， 在 FineReport 报表网页脚本中， 也提供了获取参数控件实际值， 显示值并给参数置数的方法。 /取当前控件的实际值取当前控件的实际值 FineReport-报表技术领跑者 南京帆软软件公司 商务咨询电话：86-025-5186 2240 商务咨询邮箱： 公司网址： var ParaValue = this.ge
