
# 1 功能介绍
用来显示第三方链接进来的网站内容,当与第三方合作开发时,如有需要引入对应模块,可以通过iframe将其嵌入到项目中。
# 2 控件对象
`kd.bos.form.control.IFrame`
# 3 属性说明
## 3.1 通用属性
>通用属性包含字段和控件的一些公有的属性,如宽高,帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 3.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性,请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 3.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| value | 文本 | - | iframe内嵌网址的路径 |
# 4 IFrame接口示例
* 控件方法
| 方法 | 说明 |
| --- | --- |
| setSrc | 设置iframe的src |
* 设置iframe的src
```java
IFrame iframe = this.getView().getControl("控件标识");*// 设置url*
iframe.setSrc("value");
```
* 发送一个消息到iFrame中
```java
IFrameMessage message = new IFrameMessage();
iframe.postMessage(message);
```
# 5 其他说明
* server端向第三方发送消息(pageId存在第三方页面的地址中, 由苍穹平台自动插入):
* server端调用iframe.postMessage方法(控件级方法), 触发苍穹前端postMessage_reduce方法;
* 前端将获取到的参数(苍穹后端和第三方页面约定的操作类型, 参数值, 第三方的页面地址)通过H5的postMessage再向第三方发送消息;
* 第三方需要在全局监听message方法, 用以接收父级页面传过来的值
```java
*// 监听消息'message',响应其他页面请求*
function addEventListenerOfMessage (cb) {
*// 为window注册message事件并绑定监听函数*
if (window.addEventListener) {
window.removeEventListener('message', cb, false)
window.addEventListener('message', cb, false)
} else if (window.attachEvent) { *// 兼容*
window.detach