FineReport報(bào)表采用jquery v1.5.2框架，jQuery是一個(gè)快速的，簡(jiǎn)潔的javaScript庫(kù)，使用戶能更方便地處理HTML documents、events、實(shí)現(xiàn)動(dòng)畫(huà)效果，方便地為網(wǎng)站提供AJAX交互，并且它兼容各種瀏覽器（IE 6.0+, FF 1.5+, Safari 2.0+, Opera 9.0+）。FineReport報(bào)表解析后最終成為一個(gè)html頁(yè)面，因此可以使用js對(duì)報(bào)表進(jìn)行各種處理，您可以使用jQuery框架的所有方法對(duì)報(bào)表進(jìn)行操作，在此基礎(chǔ)上，F(xiàn)ineReport還封裝了很多內(nèi)置的js方法。本文就JS的基本使用做一個(gè)介紹。

1. 如何使用JS

1.1 報(bào)表模板中使用JS

· 作用機(jī)理

設(shè)計(jì)模板時(shí)可以給控件、工具欄按鈕、整個(gè)報(bào)表添加JS事件，每個(gè)事件對(duì)應(yīng)一個(gè)function。當(dāng)報(bào)表轉(zhuǎn)為htm頁(yè)面時(shí)會(huì)將這些fuction加到html的頭部head。當(dāng)事件被觸發(fā)時(shí)如點(diǎn)擊按鈕時(shí)，或者導(dǎo)出打印報(bào)表時(shí)，對(duì)應(yīng)的function就會(huì)被執(zhí)行。

· 引入現(xiàn)成的js文件

單個(gè)模板引入外部js文件：分頁(yè)預(yù)覽、填報(bào)預(yù)覽或者數(shù)據(jù)分析旁的設(shè)置圖標(biāo)，然后點(diǎn)擊引用JavaScript；

報(bào)表工程下所有模板統(tǒng)一引入外部js文件：服務(wù)器>服務(wù)器配置>引用JavaScript。

相對(duì)路徑引用js：相對(duì)于報(bào)表工程目錄如WebReport，如WebReport\js下有引用的js文件test.js，則相對(duì)路徑為js/test.js；

絕對(duì)路徑引用js：如D:\tomcat\webapps\WebReport\WEB-INF\scripts\script.js。

· 事件編輯界面

FineReport有統(tǒng)一的事件編輯界面，如按鈕控件設(shè)置>事件編輯>添加點(diǎn)擊事件便可看到事件編輯界面了，如下圖。

1.2 自定義頁(yè)面中使用JS

· 通過(guò)獲取iframe中的報(bào)表再使用FineReport的js方法

如：報(bào)表嵌入在frame的id為"reportFrame"時(shí)，調(diào)用報(bào)表的打印預(yù)覽方法，如下：

1. document.getElementById('reportFrame').contentWindow.contentPane.printPreview();  

· 引入FineReport的js文件再使用FineReport的js方法

1. <script type="text/javascript" src="/WebReport/ReportServer?op=resource&resource=/com/fr/web/jquery.js"></script>   

2. <script type="text/javascript" src="/WebReport/ReportServer?op=emb&resource=finereport.js"></script>  

3. <script type='text/javascript'>   

4. function doPrint(){   

5.      var url="http://localhost:8075/WebReport/ReportServer?reportlet=gettingstarted.cpt";//端口和ip根據(jù)具體情況設(shè)定   

6.      FR.doURLFlashPrint(url);   

7. }   

8.  </script>   

注：若該頁(yè)面中引入了其他版本的jquery.js，可能會(huì)有js沖突，因此建議您通過(guò)獲取iframe中的報(bào)表再使用FineReport的js方法。

2. JS語(yǔ)法

2.1 普通的JS語(yǔ)法

如在事件編輯里面彈出對(duì)話框，使用alert(要彈出內(nèi)容)即可。

2.2 jQuery語(yǔ)法

jQuery的基礎(chǔ)語(yǔ)法是：$("tr")，美元符號(hào)$定義 jQuery；選擇符("tr")就可以獲取頁(yè)面所在行。

更多jQuery方法請(qǐng)參考其官方jQuery Version 1.5 API文檔。

2.3 報(bào)表內(nèi)置的JS方法

如何使用報(bào)表內(nèi)部定義好的js方法，可在事件編輯里面直接調(diào)用，如FR.doURLFlashPrint調(diào)用Flash打印，代碼如下：

1. FR.doURLFlashPrint("http://localhost:8075/WebReport/ReportServer?reportlet=gettingstarted.cpt");