适用场景:安装了「FineVis数据可视化」插件的用户,可参考本文了解 FineVis 的相关功能。
版本
报表服务器版本 | 插件版本 | 功能变动 |
---|---|---|
11.0.16 | V1.17.0 | 新增页面与网页框通信接口: onlyCommunicateWithOrigins 、postMessage 、addPostMessageListener 、removePostMessageListener |
onlyCommunicateWithOrigins
方法 | onlyCommunicateWithOrigins(origins) | 通信前指定和 FVS 通信的 origins,否则无法进行通信 |
---|---|---|
参数 | origins:string[] | 指定通信的域,是一个字符串数组 |
返回值 | - | - |
示例 | 示例:给FVS模板添加页面加载结束事件
若想实现动态获取当前域,可参考如下代码:
| |
应用示例 | JS实现FVS网页框通信 | |
移动端 | 不支持 |
postMessage
方法 | postMessage(message) | 发送消息 |
---|---|---|
参数 | message: any | 消息:任意格式 |
返回值 | - | - |
示例 | 示例:在 FVS 模板中给标题组件添加点击事件
| |
应用示例 | JS实现FVS网页框通信 | |
移动端 | 不支持 |
addPostMessageListener
方法 | addPostMessageListener(callback) | 监听来自网页框(origins指定的)的信息 |
---|---|---|
参数 | callback: (message: any) => void | 回调函数 |
返回值 | id | 监听事件的 id |
示例 | 示例:在 FVS 模板中,给 area 文本框控件添加初始化后事件,监听来自网页框的消息,并将其赋值给文本框控件
| |
应用示例 | JS实现FVS网页框通信 | |
移动端 | 不支持 |
removePostMessageListener
方法 | removePostMessageListener(id) | 删除 addPostMessageListener 添加的监听 |
---|---|---|
参数 | id:string | id:addPostMessageListener 函数的返回值 |
返回值 | - | - |
示例 | 示例:获取 addPostMessageListener 监听 id,如果不再需要监听,需及时删除
| |
应用示例 | - | |
移动端 | 不支持 |