IFrame 窗口小部件

IFrame 窗口小部件是可用于嵌入其他应用程序的特殊窗口小部件。此窗口小部件创建 HTML iframe。

IFrame 窗口小部件支持以下属性:

frameId -字符串。 iframe 的标识。
frameSrc -字符串。与要装入的页面的 URL 相对应的 iframe 的 src 属性。
注: 某些 Web 站点 (例如， google 或 yahoo) 会阻止自己嵌入到包含在其他应用程序中的 iFrame 中。因此，请确保必要的 Web 站点不施加此类限制。
applyCSRF -布尔值。指示 CSRF 令牌是否必须是 iframe 的 URL 的一部分。缺省值是 true。
qryParamsList -数组。包含必须属于 iframe 的 URL 的查询参数数组。每个查询参数都是一个 JSON 对象，并且包含以下属性:
- name -字符串。参数名称。
- value -字符串。参数值。
frameClass -字符串。使用 CSS 类来设置 iframe 的样式。缺省值为 scIFrame。
frameScrolling -字符串。设置 iframe 的滚动属性。要在 iframe 中启用滚动，请将此属性的值设置为 yes。缺省情况下，该值设置为 no。值 auto 也可用。
frameborder -数字。指定是否显示 iframe 的边框。有效值为 0 和 1。缺省值为 0。

您可以使用以下任何方法在应用程序中添加 IFrame 窗口小部件:

声明式-在 <Screen>.html 文件中创建 HTML 元素，如以下样本代码中所提供。

<div data-dojo-type="sc/plat/dojo/widgets/IFrame" data-dojo-props=" uId: 'customiframe', frameId: 'sampleId', frameSrc: '<provide your application URL here>',
 applyCSRF:true,frameScrolling: 'yes' ">
</div>

以编程方式-使用 sc.plat.dojo.utils.WidgetUtils.createIframeWidget JavaScript 实用程序。有关 createIframeWidget 窗口小部件方法的更多信息，请参阅 JavaScript 文档。
- 参数
  - Screen -要在其中创建窗口小部件的屏幕实例。
  - uId -要创建的新窗口小部件的 uId 。如果传递为空，那么将返回自动生成的 uId 。
  - configObj -包含创建 IFrame 所需的所有属性 (例如 frameId， frameSrc， applyCSRF和其他属性) 的 JSON 对象。以下代码说明 JSON 对象的结构:
```
var iframeUId = _scWidgetUtils.createIframeWidget(this, null, {"IFrame": {frameId: 'pqr',frameSrc: 
'<provide your application URL here>', applyCSRF: true, frameScrolling: 'yes' }	});
```
  - 返回值-将返回新创建的窗口小部件的 uId ，这与 widgetUId相同。
要将创建的窗口小部件放在屏幕上，请使用 Dojo 提供的 placeAt 窗口小部件方法。

更新 "信息帧" 窗口小部件中装入的应用程序

使用您创建的 IFrame 窗口小部件来装入单独的应用程序，或者使用 sc.plat.dojo.utils.WidgetUtils.setIFrameSrc JavaScript 实用程序重新装入具有不同参数的现有应用程序。

参数：

screenInstance -存在 IFrame 窗口小部件的屏幕实例。
iframeUId -IFrame 窗口小部件的 uId 。
src -要装入的应用程序的 URL 。
qryParamsList -可选。包含查询参数的数组，这些参数必须是 iframe 的 URL 的一部分。每个查询参数都是一个 JSON 对象，并且包含以下属性:
- name -字符串。参数名称。
- value -字符串。参数值。