Show TOC Start of Content Area

Background documentation InputField Locate the document in its SAP Library structure

The InputField UI element allows the user to edit or display a single-line text. With an InputField, you can edit any simple data type you like. The conversion from the internal display format and, when the user has input a value, back into the internal display format is done automatically. If, after the user has input a value into the field, an error occurs during the conversion to the internal format, the value is not put back into the context, but remains in the data container. When it is next displayed, the InputField with the erroneous value is bordered in red and displayed with an error message.

The input is not checked until the roundtrip is triggered.

Note

To enable the development of Structure linkaccessible applications, the label property is checked during the syntax check.

If no label has been set, and no descriptive text has been specified for the appropriate bound context element in the ABAP Dictionary, the tooltip property is checked.

 

Caution

Note that the value of InputField is also transferred to the password mode in plain text. For this reason, applications that use the passwordField property should only run in HTTPS mode.

You can go to the HTTPS mode through an ICF service setting in transaction SICF by setting SSL for Security Requirement on the Logon Data tab on the node for your application in the HTTP service tree.

More information:

Structure linkInputField in a Table

Example of the Display with a Label

This graphic is explained in the accompanying text

 

Runtime Class

CL_WD_INPUT_FIELD

 

Properties in View Designer

Name

Type

Initial Value

Bindable

ID

STRING

(automatic)

No

Structure linkalignment

WDUI_INPUT_FIELD_ALIGNMENT

auto

Yes

Structure linkenabled

WDY_BOOLEAN

true

Yes

Structure linkexplanation

Text

 

No

Structure linkimeMode

WDUI_IMEMODE

auto

Yes

Structure linklength

I

0

Yes

Structure linkpasswordField

WDY_BOOLEAN

false

Yes

Structure linkreadOnly

WDY_BOOLEAN

false

Yes

Structure linkstate

WDUI_STATE

normal

Yes

Structure linktextDirection

WDUI_TEXT_DIRECTION

inherit

Yes

Structure linktooltip

Text

 

Yes

Structure linkvalue

Text

 

Mandatory

Structure linkvisible

WDUI_VISIBILITY

visible

Yes

Structure linkwidth

STRING

 

Yes

 

Events in View Designer

Name

Structure linkonEnter

Note

Other properties that can be inherited are defined in the associated higher-level classes. The associated UI elements are:

        Structure linkAbstractInputFields

        Structure linkUIElements

        Structure linkViewElements

Dynamic Programming

For dynamic programming, the same properties, events and aggregations are available as in the View Designer. Bear in mind the different spellings.

Dynamic Programming of Properties

View Designer Name

Runtime Name

Type

Structure linkalignment

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

Structure linkenabled

ENABLED

WDY_BOOLEAN

Structure linkexplanation

EXPLANATION

WDY_MD_TRANSLATABLE_TEXT

Structure linkimeMode

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

Structure linklength

LENGTH

I

Structure linkpasswordField

PASSWORD_FIELD

WDY_BOOLEAN

Structure linkreadOnly

READ_ONLY

WDY_BOOLEAN

Structure linkstate

STATE

WDUI_STATE

 state: normal

CL_WD_INPUT_FIELD=>E_STATE-NORMAL

 state: required

CL_WD_INPUT_FIELD=>E_STATE-REQUIRED

Structure linktextDirection

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

Structure linktooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

Structure linkvalue

VALUE

WDY_MD_TRANSLATABLE_TEXT

Structure linkvisible

VISIBLE

WDUI_VISIBILITY

 visible: none

CL_WD_INPUT_FIELD=>E_VISIBLE-NONE

 visible: visible

CL_WD_INPUT_FIELD=>E_VISIBLE-VISIBLE

Structure linkwidth

WIDTH

STRING

 

Dynamic Programming of Events

View Designer Name

Runtime Name

Structure linkonEnter

ON_ENTER

Example

You can find examples of this interface element in the system in the WDR_TEST_UI_ELEMENTS Web Dynpro application and in the WDR_TEST_EVENTS component in the InputField view.

 

 

End of Content Area