IFrame-Widget

Das I-Frame-Widget ist ein spezielles Widget, mit dem eine andere Anwendung eingebettet werden kann. Dieses Widget erstellt einen HTML-I-Frame.

Das I-Frame-Widget unterstützt die folgenden Attribute:

frameId -Zeichenfolge. Die ID des I-Frame.
frameSrc -Zeichenfolge. Das Attribut src für den I-Frame, das der URL der zu ladenden Seite entspricht.
Hinweis: Einige Websites, z. B. Google oder Yahoo, verhindern, dass sie in einen iFrame eingebettet werden, der in einer anderen Anwendung enthalten ist. Stellen Sie daher sicher, dass die erforderlichen Websites solche Einschränkungen nicht auferlegen.
applyCSRF -Boolescher Wert. Gibt an, ob das CSRF-Token Teil der URL für I-Frame sein muss. Standardwert: true.
qryParamsList -Array. Enthält ein Array von Abfrageparametern, die Teil von URL für I-Frame sein müssen Jeder Abfrageparameter ist ein JSON-Objekt und enthält die folgenden Attribute:
- name -Zeichenfolge. Der Name des Parameters.
- value -Zeichenfolge. Der Parameterwert.
frameClass -Zeichenfolge. Verwenden Sie die CSS-Klasse für den Stil-I-Frame. Der Standardwert ist scIFrame.
frameScrolling -Zeichenfolge. Legt das Blätterattribut für I-Frame fest. Um das Blättern in I-Frame zu aktivieren, setzen Sie den Wert dieses Attributs auf yes. Standardmäßig ist der Wert auf nogesetzt. Der Wert auto ist auch verfügbar.
frameborder -Zahl. Gibt an, ob ein Rahmen für I-Frame angezeigt werden soll Gültige Werte sind 0 und 1. Der Standardwert ist 0.

Sie können ein IFrame-Widget in Ihrer Anwendung mit einer der folgenden Methoden hinzufügen:

Deklarativ-Erstellen Sie ein HTML-Element in der Datei <Screen>.html , wie im folgenden Beispielcode angegeben.

<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>

Programmgesteuert-Verwenden Sie das Dienstprogramm sc.plat.dojo.utils.WidgetUtils.createIframeWidget JavaScript . Weitere Informationen zur Widgetmethode createIframeWidget finden Sie in der JavaScript -Dokumentation.
- Argumente
  - Screen -Die Anzeigeninstanz, in der das Widget erstellt werden soll
  - uId -Die uId des zu erstellenden neuen Widgets. Wenn Sie null übergeben, wird automatisch generierte uId zurückgegeben.
  - configObj -Das JSON-Objekt, das alle Attribute wie frameId, frameSrc, applyCSRFusw. enthält, die zum Erstellen eines I-Frame erforderlich sind. Der folgende Code erläutert die Struktur des JSON-Objekts:
```
var iframeUId = _scWidgetUtils.createIframeWidget(this, null, {"IFrame": {frameId: 'pqr',frameSrc: 
'<provide your application URL here>', applyCSRF: true, frameScrolling: 'yes' }	});
```
  - Rückgabewert-Die uId des neu erstellten Widgets wird zurückgegeben. Dies entspricht widgetUId.
Verwenden Sie zum Platzieren des erstellten Widgets auf dem Bildschirm die von Dojo bereitgestellte Widgetmethode placeAt .

In IFrame-Widget geladene Anwendung aktualisieren

Verwenden Sie das IFrame-Widget, das Sie erstellt haben, um entweder eine separate Anwendung zu laden oder eine vorhandene Anwendung mit anderen Parametern mithilfe des sc.plat.dojo.utils.WidgetUtils.setIFrameSrc -Dienstprogramms JavaScript erneut zu laden.

Argumente:

screenInstance -Die Anzeigeninstanz, in der das IFrame-Widget vorhanden ist.
iframeUId -Die uId des IFrame-Widgets.
src -Die URL der zu ladenden Anwendung.
qryParamsList -Optional. Enthält ein Array von Abfrageparametern, die Teil der URL für I-Frame sein müssen Jeder Abfrageparameter ist ein JSON-Objekt und enthält die folgenden Attribute:
- name -Zeichenfolge. Der Name des Parameters.
- value -Zeichenfolge. Der Parameterwert.