InputField

Verwendung

Das InputField-Oberflächenelement erlaubt dem Benutzer, einen einzeiligen Text zu editieren oder anzuzeigen. Mit einem InputField können Sie einen beliebigen einfachen Datentyp editieren. Die Konvertierung von der internen in die Anzeige-Darstellung und bei Eingabe durch den Benutzer wieder zurück in die interne Darstellung erfolgt dabei automatisch. Tritt nach der Benutzereingabe bei der Konvertierung in die interne Darstellung ein Fehler auf, so wird der Wert nicht in den Context zurückgestellt, sondern verbleibt im Data Container. Bei der nächsten Anzeige wird das InputField mit dem fehlerhaften Wert rot umrandet und mit einer Fehlermeldung versehen angezeigt.

Die Überprüfung einer Eingabe erfolgt erst durch das Auslösen eines Roundtrips.

Um Benutzern bei der Eingabe die möglichen Werte anzuzeigen, können Sie an einem an Context-Attribut, das an die Eigenschaft value eines InputFields gebunden ist, eine Wertehilfe für dieses InputField definieren. Weitere Informationen finden Sie unter Eingabehilfen.

Hinweis

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

Wenn kein label gesetzt wurde und auch für das entsprechende gebundene Context-Element im ABAP-Dictionary kein Beschreibungstext angegeben wurde, findet eine Überprüfung auf die Eigenschaft tooltip statt.

Achtung

Beachten Sie, dass der Wert des InputField auch im Passwort-Modus im Klartext übertragen wird. Anwendungen, die die Eigenschaft passwordField verwenden, sollten daher nur im HTTPS-Modus laufen

Sie können den HTTPS-Modus durch eine Einstellung am ICF-Service in der Transaktion SICF erreichen, indem Sie bei dem Knoten für Ihre Anwendung im HTTP-Service-Baum auf dem Reiter Anmelde-Daten als Sicherheitsanforderung SSL einstellen.

Beispiel für die visuelle Darstellung mit einem Label

Prüfung von Musseingabefeldern

Die Prüfung nach Musseingabefeldern ist nicht in Web Dynpro implementiert und ist auch künftig nicht vorgesehen

In den Anwendungen können Sie überprüfen, ob die Felder leer sind. Zu diesem Zweck gibt es eine Methode, die von der Anwendung verwendet wird.

Rufen Sie die Methode CL_WD_DYNAMIC_TOOL=>CHECK_MANDATORY_ATTRIBUTES in Ihrem Action-Handler oder in Methode wdDoBeforeAction auf. Ein Beispiel hierfür ist die Web-Dynpro-Anwendung WDR_TEST_MANDATORY.
In den Anwendungen können Sie überprüfen, ob die Musseingabefelder einer vollständigen View leer sind. Dabei werden auch personalisierte Musseingabefelder berücksichtigt.

Rufen Sie die Methode CL_WD_DYNAMIC_TOOL=>CHECK_MANDATORY_ATTR_ON_VIEW in Ihrem Action-Handler oder in Methode wdDoBeforeAction auf. Ein Beispiel hierfür ist die Web-Dynpro-Anwendung WDR_TEST_MANDATORY.

Designvorgaben für die Eigenschaften readOnly im Gegensatz zu enabled

Sie sollten nur dann Felder auf enabled=false setzen, wenn diese Felder für den Benutzer nicht relevant für seine momentane Arbeit sind und im Rahmen des aktuellen Kontextes auch nicht relevant sein werden. Aus diesem Grund wird ein Feld mit disabled=false auch so auf dem Bildschirm ausgegeben, dass die Aufmerksamkeit des Benutzers nicht darauf gelenkt wird. So wird in diesem Fall auch der Schrifttyp des Labels grau dargestellt, damit er sich dem ausgegrauten InputField anpasst.

Beispiel

Beispiel für ein InputField mit enabled=false:

Read-only Felder dagegen sollten nur für Felder verwendet werden, die relevant für die momentane Arbeit des Benutzers sind, und die auch zu einem späteren Zeitpunkt geändert werden können, jedoch nur nicht gerade in diesem Moment.

Daten, die relevant sind für den aktuellen Kontext, die aber hier niemals editierbar sind, sollten aktuell mittels eines TextViews dargestellt werden. Dies hat allerdings zur Folge, dass z.B. per Tastatur keine Feldhilfe aufgerufen werden kann und auch keine Feld-Explanation (siehe Hilfetexte in und für Web-Dynpro-Applikationen) angehängt werden kann.

Implementierungsdetails

Laufzeit-Klasse

CL_WD_INPUT_FIELD

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
activateAccessKey	WDY_BOOLEAN	false	nein
alignment	WDUI_INPUT_FIELD_ALIGNMENT	auto	ja
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
datePickerReferenceId	WDY_MD_UI_ELEMENT_REFERENCE		nein
displayAsText	WDY_BOOLEAN	false	ja
displayOnly	WDY_BOOLEAN	false	ja
enabled	WDY_BOOLEAN	true	ja
explanation	Übersetzbarer Text		nein
imeMode	WDUI_IMEMODE	auto	ja
inputHelp	WDUI_INPUTHELP	auto	ja
inputPrompt	Übersetzbarer Text		ja
length	l	20	ja
noHistory	WDY_BOOLEAN	false	nein
passwordField	WDY_BOOLEAN	false	ja
readOnly	WDY_BOOLEAN	false	ja
state	WDUI_STATE	normal	ja
styleClassName	STRING		ja
suggestFilterMethod	WDUI_SUGGEST_FILTER_METHOD	prefixSearch	ja
suggestValues	WDY_BOOLEAN	false	ja
suppressValueHelp	WDY_BOOLEAN	false	ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
tooltip	Übersetzbarer Text		ja
value	Übersetzbarer Text		muss
visible	WDUI_VISIBILITY	visible	ja
width	STRING		ja

Events im View Designer

Name
onEnter
onTablePaste

Hinweis

Weitere Eigenschaften, die über Vererbung zur Verfügung 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.

Dynamische Programmierung der Eigenschaften

View Designer Name	Laufzeitname	Typ
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
alignment	ALIGNMENT	WDUI_INPUT_FIELD_ALIGNMENT
alignment: auto	CL_WD_INPUT_FIELD=>E_ALIGNMENT-AUTO
alignment: beginOfLine	CL_WD_INPUT_FIELD=>E_ALIGNMENT-BEGIN_OF_LINE
alignment: center	CL_WD_INPUT_FIELD=>E_ALIGNMENT-CENTER
alignment: endOfLine	CL_WD_INPUT_FIELD=>E_ALIGNMENT-END_OF_LINE
alignment: forcedLeft	CL_WD_INPUT_FIELD=>E_ALIGNMENT-FORCED_LEFT
alignment: forcedRight	CL_WD_INPUT_FIELD=>E_ALIGNMENT-FORCED_RIGHT
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuehaviour: inherit	CL_WD_INPUT_FIELD=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_INPUT_FIELD=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_INPUT_FIELD=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
datePickerReferenceId	DATE_PICKER_REFERENCE_ID	WDY_MD_UI_ELEMENT_REFERENCE
displayAsText	DISPLAY_AS_TEXT	WDY_BOOLEAN
displayOnly	DISPLAY_ONLY	WDY_BOOLEAN
enabled	ENABLED	WDY_BOOLEAN
explanation	EXPLANATION	WDY_MD_TRANSLATABLE_TEXT
imeMode	IME_MODE	WDUI_IMEMODE
imeMode: active	CL_WD_INPUT_FIELD=>E_IME_MODE-ACTIVE
imeMode: auto	CL_WD_INPUT_FIELD=>E_IME_MODE-AUTO
imeMode: disabled	CL_WD_INPUT_FIELD=>E_IME_MODE-DISABLED
imeMode: inactive	CL_WD_INPUT_FIELD=>E_IME_MODE-INACTIVE
inputHelp	INPUT_HELP	WDUI_INPUTHELP
inputHelp: auto	CL_WD_INPUT_FIELD=>E_INPUT_HELP-AUTO
inputHelp: calculator	CL_WD_INPUT_FIELD=>E_INPUT_HELP-CALCULATOR
inputHelp: none	CL_WD_INPUT_FIELD=>E_INPUT_HELP-NONE
inputHelp: search	CL_WD_INPUT_FIELD=>E_INPUT_HELP-SEARCH
inputPrompt	INPUT_PROMPT	WDY_MD_TRANSLATABLE_TEXT
length	LENGTH	I
noHistory	NO_HISTORY	WDY_BOOLEAN
passwordField	PASSWORD_FIELD	WDY_BOOLEAN
readOnly	READ_ONLY	WDY_BOOLEAN
state	STATE	WDUI_STATE
state: normal	CL_WD_INPUT_FIELD=>E_STATE-NORMAL
state: required	CL_WD_INPUT_FIELD=>E_STATE-REQUIRED
styleClassName	STYLE_CLASS_NAME	STRING
suggestFilterMethod	SUGGEST_FILTER_METHOD	WDUI_SUGGEST_FILTER_METHOD
suggestFilterMethod: containsSearch	CL_WD_INPUT_FIELD=>E_SUGGEST_FILTER_METHOD-CONTAINS
suggestFilterMethod: prefixSearch	CL_WD_INPUT_FIELD=>E_SUGGEST_FILTER_METHOD-PREFIX
suggestValues	SUGGEST_VALUES	WDY_BOOLEAN
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_INPUT_FIELD=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_INPUT_FIELD=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_INPUT_FIELD=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
value	VALUE	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_INPUT_FIELD=>E_VISIBLE-NONE
visible: visible	CL_WD_INPUT_FIELD=>E_VISIBLE-VISIBLE
width	WIDTH	STRING

Dynamische Programmierung der Ereignisse

View Designer Name	Laufzeitname
onEnter	ON_ENTER
onTablePaste	ON_TABLE_PASTE

Beispiel

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

Weitere Informationen

InputField in einer Table