HTMLContainer

Verwendung

Die UI-Elemente HTMLContainer und HTMLIsland ermöglichen es, kundeneigene HTML-, JavaScript- und CSS-Quellen in Web-Dynpro-ABAP-Anwendungen zu integrieren. Dadurch können Sie das Standard Web Dynpro um neue Bestandteile erweitern.

Mithilfe des HTMLContainers können Sie HTML- oder JavaScript-basierte UI-Controls in Ihre Web-Dynpro-Anwendung integrieren (z.B. ein erweitertes UI-Control für die Bearbeitung von formatiertem Text) oder vorhandene Web Dynpro UI-Elemente mit HTML anreichern (z.B. Table mit Hintergrundbild).

Über die Aggregation CONTENT können Sie HTMLFragments in den HTMLContainer einfügen. Dadurch können Sie in eine Web-Dynpro-Anwendung vollständigen HTML-Quellcode oder HTML-Fragmente, die andere Inhalte umschließen, einbinden. Der HTMLContainer erzeugt HTML auf Server-Seite. Bei jedem Server-Rountrip wird der Inhalt des HTMLContainers komplett neu aufgebaut.

Context-Attribute werden im HTMLContainerüber die Aggregation DATA_ELEMENTS zur Verfügung gestellt. Außerdem ist es möglich, Ereignisse zu deklarieren, die von der HTML-Anwendung ausgelöst und vom Web-Dynpro-Framework verarbeitet werden sollen.

Hinweis

Führen Sie Web-Dynpro-Anwendungen, die UI-Elemente zur Integration von HTML verwenden, immer im Standards-Modus des Browsers aus. Setzen Sie dazu den Anwendungsparameter WDPREFERREDRENDERING auf den Wert STANDARDS.

Weitere Informationen finden Sie unter Applikationsparameter und URL-Parameter.

Weitere Informationen: HTML-Integration

Implementierungsdetails

Laufzeit-Klasse:

CL_WD_HTML_CONTAINER

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
enabled	WDY_BOOLEAN	true	ja
height	STRING		ja
styleClassName	STRING		ja
tooltip	übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja
width	STRING		ja

Aggregationen im View Designer

Name	Kardinalität	Typ
CONTENT	0..n	UIElement
DATA_ELEMENTS	0..n	JSONData
EVENTS	0..n	HtmlEvent
SCRIPTS	0..n	HtmlScript
STYLES	0..n	HtmlStyle

Verwendung

Hinweis

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

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.

View Designer Name	Laufzeitname	Typ
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_C_TABLE=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_C_TABLE=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_C_TABLE=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
height	HEIGHT	STRING
styleClassName	STYLE_CLASS_NAME	STRING
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_C_TABLE=>E_VISIBLE-NONE
visible: visible	CL_WD_C_TABLE=>E_VISIBLE-VISIBLE
width	WIDTH	STRING

View Designer Name	Laufzeitname	Kardinalität
CONTENT	CONTENT	0..n
DATA_ELEMENTS	DATA_ELEMENTS	0..n
EVENTS	EVENTS	0..n
SCRIPTS	SCRIPTS	0..n
STYLES	STYLES	0..n

Beispiel

Für Tests steht Ihnen die Component WDR_TEST_HTML_ELEMENT im System zur Verfügung.