微信公众号:次世代数据技术 关注可了解更多的教程。问题或建议,请公众号留言或联系本人; 如果您有报表开发需求或者定制化功能开发,也可以联系本人; 微信号:weibw162
本教程视频讲解可以关注本人B站账号进行观看:次世代数据技术
一、需求描述
目前FineReport的超级链接仅支持单击弹窗打开报表,本文提供一种右击弹窗打开菜单,且点击菜单项可以各种方式打开报表。其实现效果大致如下:
针对以上需求,本文提出一种可行的方案,其大致步骤如下:
- 在需要增加右键菜单的模板中导入
right-click-menu.js
。 - 通过
JQ
给指定单元格增加右击事件。
注1:不支持移动端。注2:本文涉及到的技术及流程均仅在FineReport 11.0 版本进行实际验证,如果您在使用其他版本过程中出现问题可以联系本作者。
二、具体操作
第一步
下载right-click-menu.js
文件,并保存到工程目录下,具体目录:webroot
>help
>js
。
第二步
在模板中引入该js文件。具体操作为,点击左上角 模板
->模板web属性
->引入JavaScript
->选中上一步的JavaScript文件并添加。
第三步
给模板增加一个加载结束
事件,具体操作为,点击左上角 模板
->模板web属性
->分页预览设置
,然后点击左下角的事件设置
里增加一个加载结束
事件,并写入如下JavaScript脚本。 JavaScript 代码如下:
$('td[id^="A"]:not(td[id^="A1-"],td[id^="A2-"],td[id^="A3-"],td[id^="A4-"],td[colspan="6"])').each(function () {
var menulist = [
{
"name": "订单明细表[弹窗显示]",
"type": "dialog",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"width": 800,
"height": 400,
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[平台内新标签]",
"type": "fsnewtab",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
}
},
{
"name": "订单明细表[平台内当前标签]",
"type": "fsselftab",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[新开窗口]",
"type": "newwindow",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
}
},
{
"name": "订单明细表[当前窗口]",
"type": "selfwindow",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
}
},
{
"name": "订单明细表[抽屉右侧打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titlehtml": "",
"titleStyle": {
"font-size": "16px",
"color": "red",
"font-weight": "700"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "right",
"size": "800px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[抽屉左侧打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titlehtml": "",
"titleStyle": {
"font-size": "16px",
"color": "rgba(0,0,255,0.5)",
"font-weight": "800"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "left",
"size": "800px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[抽屉顶部打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titlehtml": "",
"titleStyle": {
"font-size": "16px",
"color": "rgba(0,0,255,0.5)",
"font-weight": "800"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "top",
"size": "400px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[抽屉底部打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titleHtml": "<div style='background-image:url(\"" + "/webroot/help/picture/dd.png" + "\");width:20px;height:20px;display:inline-block;vertical-align:middle;'></div><span style='vertical-align:middle;margin-left:5px'>订单明细表[支持自定义title元素]</span>",
"titleStyle": {
"font-size": "16px",
"color": "rgba(0,0,255,0.5)",
"font-weight": "800"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "bottom",
"size": "450px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[自定义菜单项样式]",
"type": "dialog",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"width": 1234,
"height": 666,
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
"style": {
"color": "blue",
"font-weight": "800",
"background": "rgba(0,255,0,0.2)",
"cursor": "pointer"
}
},
{
"name": "订单明细表[自定义菜单元素]",
"type": "fsselftab",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
"style": { "font-size": "16px", "cursor": "pointer", "color": "#ff7744" },
"html": "<div style='background-image:url(\"" + "/webroot/help/picture/dd.png" + "\");width:20px;height:20px;display:inline-block;vertical-align:middle;'></div><span style='vertical-align:middle;margin-left:5px'>订单明细表[自定义元素]</span>"
},
{
"name": "执行方法[支持自定义函数]",
"type": "func",
"args": {
"func": function () {
FR.Msg.alert("警告", "这是一个自定义的函数执行!");
}
},
},
]
// var boxStyle = {
// "width": "300px",
// "background": "#a8bf8f",
// "border-radius": "10px",
// "border": "1px solid #D3D3D3",
// "padding": "10px 10px"
// }
// var itemHoverColor = "#ffee6f";
RCM($(this), menulist);
});
$('td[id^="A"]:not(td[id^="A1-"],td[id^="A2-"],td[id^="A3-"],td[id^="A4-"],td[colspan="6"])').each(function () {
var menulist = [
{
"name": "订单明细表[弹窗显示]",
"type": "dialog",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"width": 800,
"height": 400,
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[平台内新标签]",
"type": "fsnewtab",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
}
},
{
"name": "订单明细表[平台内当前标签]",
"type": "fsselftab",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[新开窗口]",
"type": "newwindow",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
}
},
{
"name": "订单明细表[当前窗口]",
"type": "selfwindow",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
}
},
{
"name": "订单明细表[抽屉右侧打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titlehtml": "",
"titleStyle": {
"font-size": "16px",
"color": "red",
"font-weight": "700"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "right",
"size": "800px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[抽屉左侧打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titlehtml": "",
"titleStyle": {
"font-size": "16px",
"color": "rgba(0,0,255,0.5)",
"font-weight": "800"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "left",
"size": "800px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[抽屉顶部打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titlehtml": "",
"titleStyle": {
"font-size": "16px",
"color": "rgba(0,0,255,0.5)",
"font-weight": "800"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "top",
"size": "400px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[抽屉底部打开]",
"type": "drawer",
"args": {
"title": "订单明细表",
"titleHtml": "<div style='background-image:url(\"" + "/webroot/help/picture/dd.png" + "\");width:20px;height:20px;display:inline-block;vertical-align:middle;'></div><span style='vertical-align:middle;margin-left:5px'>订单明细表[支持自定义title元素]</span>",
"titleStyle": {
"font-size": "16px",
"color": "rgba(0,0,255,0.5)",
"font-weight": "800"
},
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"positon": "bottom",
"size": "450px",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
},
{
"name": "订单明细表[自定义菜单项样式]",
"type": "dialog",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"width": 1234,
"height": 666,
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
"style": {
"color": "blue",
"font-weight": "800",
"background": "rgba(0,255,0,0.2)",
"cursor": "pointer"
}
},
{
"name": "订单明细表[自定义菜单元素]",
"type": "fsselftab",
"args": {
"title": "订单明细表",
"templateUrl": "/webroot/decision/view/report?viewlet=文档示例模板/JS实现右键弹窗打开报表/JS实现右键弹窗打开报表-子表.cpt",
"params": {
"订单号": $(this).find('span div').text() || $(this).find('div').text(),
},
},
"style": { "font-size": "16px", "cursor": "pointer", "color": "#ff7744" },
"html": "<div style='background-image:url(\"" + "/webroot/help/picture/dd.png" + "\");width:20px;height:20px;display:inline-block;vertical-align:middle;'></div><span style='vertical-align:middle;margin-left:5px'>订单明细表[自定义元素]</span>"
},
{
"name": "执行方法[支持自定义函数]",
"type": "func",
"args": {
"func": function () {
FR.Msg.alert("警告", "这是一个自定义的函数执行!");
}
},
},
]
// var boxStyle = {
// "width": "300px",
// "background": "#a8bf8f",
// "border-radius": "10px",
// "border": "1px solid #D3D3D3",
// "padding": "10px 10px"
// }
// var itemHoverColor = "#ffee6f";
RCM($(this), menulist);
});
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
完成以上配置后,我们直接点击左上角的选择分页预览按钮,即可在浏览器中查看到与文章开头效果图类似的报表。
三、API解释
RCM(el, menulist, boxStyle, itemHoverColor);
RCM(el, menulist, boxStyle, itemHoverColor);
参数解释
参数名 | 是否必填 | 参数解释 |
---|---|---|
el | 是 | 需要增加右键菜单的DOM元素,必须为单元素,不可为对象数组 |
menulist | 是 | 右键菜单项,必须为json数组,具体内容可以参考下方配置表 |
boxStyle | 否 | 右键菜单样式,可以调整菜单框的大小背景等样式 |
itemHoverColor | 否 | 右键菜单项hover背景色,可以调整菜单项鼠标略过时的背景颜色,示例#fff |
menulist属性解释
属性名 | 是否必填 | 属性解释 |
---|---|---|
name | 是 | 菜单项名称 |
type | 是 | 菜单项点击后的效果类型,可选项'dialog'、'fsnewtab'、'fsselftab'、'newwindow'、'selfwindow'、'drawer'、'func',具体可参考下面的解释 |
args | 是 | 菜单项配置所需参数,json对象 |
style | 否 | 单个菜单项的样式,可以设置菜单项的背景色字体大小等样式 |
html | 否 | 单个菜单项的渲染html元素,支持自定义,比如在菜单项前面增加一个icon图标,当该项有值时title属性将失去效果 |
type属性解释
属性值 | 属性解释 |
---|---|
dialog | 弹窗展示报表或网页 |
fsnewtab | 在平台内新标签打开报表或网页 |
fsselftab | 在平台内当前标签页打开报表或网页 |
newwindow | 浏览器新页签打开报表或网页 |
selfwindow | 浏览器当前页签打开报表或网页 |
drawer | 以抽屉的形式打开报表或网页 |
func | 自定义function,可以自定义函数执行动作 |
type属性值为dialog、fsnewtab、fsselftab、newwindow、selfwindow时的args属性解释
属性值 | 是否必填 | 属性解释 |
---|---|---|
title | 是 | 窗口展示报表或网页时的标题 |
templateUrl | 是 | 需要打开的报表的地址或网页地址,url参数请使用params参数,不用直接在该项后面拼接 |
params | 否 | 请求url参数,需要传输key:value形式的json |
width | 是 | dialog独有,表示弹窗的宽度 |
height | 是 | dialog独有,表示弹窗的高度 |
type属性值为drawer时的args属性解释
属性值 | 是否必填 | 属性解释 |
---|---|---|
title | 是 | 窗口展示报表或网页时的标题 |
templateUrl | 是 | 需要打开的报表的地址或网页地址,url参数请使用params参数,不用直接在该项后面拼接 |
params | 否 | 请求url参数,需要传输key:value形式的json |
titleHtml | 否 | 标题中的html元素,可以自定义元素,比如在标题前面增加一个icon图标,当该项有值时title属性将失去效果 |
titleStyle | 否 | 标题的样式,可以自定义标题的文字及背景样式 |
positon | 是 | 抽屉弹出的方向,可选项为'left'、'right'、'top'、'bottom',分别代表左右上下 |
size | 是 | 弹出窗口的大小,当弹出方向为上下时代表高度,弹出方向为左右时代表宽度 |
type属性值为func时的args属性解释
属性值 | 是否必填 | 属性解释 |
---|---|---|
func | 是 | 点击菜单时执行的函数,可以自定义事件;例:function() {FR.Msg.alert("警告", "这是一个自定义的函数执行!");} |
四、模板文件下载
扫码即可下载文档示例模板及其他代码文件 如果您在阅读或实际操作过程中有问题,可以随时添加作者好友进行咨询。