IFrame
Wir können die Verwendung des IFrame UI-Elementes nur mit Einschränkungen empfehlen. Ein IFrame ist ein Bereich des Browser-Fensters, in dem zustandslose Inhalte (Bilder, Dokumente…) über eine eigene Source-URI dargestellt werden. Diese Source wird im IFrame genauso dargestellt und vom Browser behandelt wie ein zustandsloses Dokument. Daher ergeben sich insbesondere folgende Konsequenzen:
Bei der Einbettung interaktiver zustandsbehafteter Applikationen, z.B. BSP- und JSP-Applikationen, werden diese nach dem Verlassen der gesamten Seite in ihrem aktuellen Zustand zurückgelassen. Beim erneuten Aufruf der Seite, etwa durch Zurücknavigieren, wird der Inhalt des IFrame komplett neu aufgebaut. Insbesondere heisst das für die zustandsbehaftete Anwendung, dass sie wieder initial gestartet wird. Damit würde z.B. der Kontext der eingebetteten Anwendung zweimal am Backend vorhanden sein, da mit der Verwendung des IFrames keinerlei übergreifendes Session-Handling von Web Dynpro ABAP unterstützt wird. Insbesondere kann das Web Dynpro Framework (mehrfach) bestehende Sessions, die durch die Verwendung des IFrames initiiert wurden, nicht schließen.
Im Speziellen wird die Einbindung von Web-Dynpro-Anwendungen in IFrames nicht unterstützt.
Für die Einbettung von Dokumenten steht Ihnen dasOfficeControl und für PDF-Formulare dasInteractiveForm-Oberflächenelement zur Verfügung. Für die Einbettung von Hilfe-Texten u.ä. können Sie die entsprechenden UI-Elemente verwenden, beispielsweise Explanation und das explanation-Property an einer Reihe von UI-Elementen (z.B. InputField, Button, etc.).
Beachten Sie weiterhin, dass die Barrierefreiheit des Inhalts eines IFrame durch Web Dynpro nicht bereitgestellt wird. Das heisst, für die Barrierefreiheit des im IFrame dargestellten Inhaltes ist das Projekt verantwortlich, in dessen Verantwortungbereich der IFrame verwendet wird. Dasselbe gilt für Right-to-Left (RTL)- Support.
Das IFrame darf nicht in einemScrollContainer mit scrollingMode ungleich none verwendet werden. Der ScrollContainer ist obsolet.
Die Verwendung eines IFrame in scrollenden Containern wie Group, Tray oder TransparentContainer mit Scrollbars sowie in Dialogfenstern (Popups) ist nicht zulässig.
Beispiel für die visuelle Darstellung: IFrame in einem MatrixLayout mit hinterlegter Schattierung
|
|
Um die Entwicklungbarrierefreier 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 |
|---|---|---|---|
|
STRING |
(automatisch) |
nein |
|
|
WDY_BOOLEAN |
false |
ja |
|
|
WDUI_CONTEXT_MENU_BEHAVIOUR |
inherit |
nein |
|
|
WDY_MD_UI_ELEMENT_REFERENCE |
nein |
||
|
WDY_BOOLEAN |
true |
ja |
|
|
STRING |
300 |
ja |
|
|
WDUI_LIFE_TIME |
whenVisible |
ja |
|
|
WDUI_SCROLLING_MODE |
auto |
ja |
|
| styleClassName | STRING | ja | |
|
STRING |
ja |
||
|
Übersetzbarer Text |
ja |
||
|
WDUI_VISIBILITY |
visible |
ja |
|
|
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:
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 |
WDY_BOOLEAN |
|
|
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 |
|
|
CONTEXT_MENU_ID |
WDY_MD_UI_ELEMENT_REFERENCE |
|
|
ENABLED |
WDY_BOOLEAN |
|
|
HEIGHT |
STRING |
|
|
LIFE_TIME |
WDUI_LIFE_TIME |
|
|
lifeTime: whenAlive |
CL_WD_IFRAME=>E_LIFE_TIME-WHEN_ALIVE |
|
|
lifeTime: whenVisible |
CL_WD_IFRAME=>E_LIFE_TIME-WHEN_VISIBLE |
|
|
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 |
STRING |
|
| styleClassName | STYLE_CLASS_NAME | STRING |
|
TOOLTIP |
WDY_MD_TRANSLATABLE_TEXT |
|
|
VISIBLE |
WDUI_VISIBILITY |
|
|
visible: none |
CL_WD_IFRAME=>E_VISIBLE-NONE |
|
|
visible: visible |
CL_WD_IFRAME=>E_VISIBLE-VISIBLE |
|
|
WIDTH |
STRING |
Beispiele für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS.