IFrame 

Dieses UI-Element ist deprecated, verwenden Sie es daher nicht mehr.

Stattdessen können Sie mit dem Portal Anwendungen integrieren, die nicht auf dem Web Dynpro Programmiermodell basieren. Für die Einbettung von Hilfe-Texten u.ä. stehen die entsprechenden UI-Elemente zur Verfügung, beispielsweise Explanation und das explanation-Property an einer Reihe von UI-Elementen (z.B. InputField, Button, etc.). Für die Einbettung von Dokumenten gibt es das OfficeControl und für PDF-Formulare das InteractiveForm-Oberflächenelement.

Wenn Sie dieses UI-Element dennoch verwenden, beachten Sie, dass bei der Einbettung interaktiver zustandsbehafteter Applikationen, z.B. BSP- oder JSP-Applikationen, diese in Verbindung mit Navigationsschritten immer wieder nach jedem Server-Roundtrip neu geladen werden. Mit der Verwendung des IFrames wird keinerlei Session-Handling unterstützt. Insbesondere kann das Web Dynpro Framework bestehende Sessions, die über die Verwendung des IFrames initiiert wurden, nicht schließen.

Beachten Sie auch, dass bei einem Refresh das IFrame ebenfalls aktualisiert wird.

Im Portal oder im Business Client sollten Sie ein separates iView mit einer festen oder dynamischen URL einrichten statt eines Iframes.

Beachten Sie, dass die Barrierefreiheit des Inhalts eines IFrame auf keinen Fall von Web Dynpro bereitgestellt werden kann. Das heisst, für die Barrierefreiheit des im IFrame dargestellten Inhaltes ist das Projekt verantwortlich, in dessen Anwendungen das IFrame verwendet wird.

Das Oberflächenelement IFrame stellt einen durch einen Rahmen abgegrenzten Bereich, der eine separate Browser-Seite enthält, innerhalb einer View dar. Dieser Rahmen kann dazu genutzt werden, um externe Quellen wie beispielsweise HTML-Seiten innerhalb eines bestimmten Bereichs der Benutzungsoberfläche anzuzeigen. Ein vertikaler sowie horizontaler Bildlauf wird in der Regel aktiviert, um den Inhalt dieses Oberflächenelements sichten zu können. Innerhalb dieses Rahmens ist es möglich, wie im folgenden Bild zu erkennen, durch den Inhalt zu blättern.

Der Inhalt des IFrame bleibt bei jedem Roundtrip unberührt. Das heisst, beispielsweise werden die Scrolling-Position oder mögliche Eingaben in Eingabefelder einer Webseite, die in dem IFrame angezeigt wird, nicht verändert. Das IFrame wird nur komplett neu aufgebaut, falls eines seiner Properties verändert wird. Dies ist z.B. dann der Fall, wenn Sie ein SPACE an die URL (d.h. Eigenschaft source) anhängen.

Das IFrame darf nicht in einem ScrollContainer mit scrollingMode ungleich none verwendet werden. Auch der ScrollContainer ist deprecated.

Beispiel für die visuelle Darstellung:
IFrame in einem MatrixLayout mit hinterlegter Schattierung

Um die Entwicklung barrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft tooltip überprüft.

 

Laufzeit-Klasse

CL_WD_IFRAME

 

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
border	WDY_BOOLEAN	false	ja
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
enabled	WDY_BOOLEAN	true	ja
height	STRING	300	ja
scrollingMode	WDUI_SCROLLING_MODE	auto	ja
source	STRING		ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja
width	STRING	300	ja

Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:

●        UIElement

●        ContextMenuProvider

●        ViewElement

Dynamische Programmierung

Für die dynamische Programmierung stehen dieselben Eigenschaften, Ereignisse und Aggregationen zur Verfügung wie im View Designer. Beachten Sie dabei die unterschiedlichen Schreibweisen.

Dynamische Programmierung der Eigenschaften

View Designer Name	Laufzeitname	Typ
border	BORDER	WDY_BOOLEAN
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_IFRAME=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_IFRAME=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_IFRAME=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
height	HEIGHT	STRING
scrollingMode	SCROLLING_MODE	WDUI_SCROLLING_MODE
scrollingMode: auto	CL_WD_IFRAME=>E_SCROLLING_MODE-AUTO
scrollingMode: both	CL_WD_IFRAME=>E_SCROLLING_MODE-BOTH
scrollingMode: none	CL_WD_IFRAME=>E_SCROLLING_MODE-NONE
source	SOURCE	STRING
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_IFRAME=>E_VISIBLE-NONE
visible: visible	CL_WD_IFRAME=>E_VISIBLE-VISIBLE
width	WIDTH	STRING

 

Beispiel

Beispiele für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS.