Erscheinungsbild
Input
Ein Eingabefeld für einzeilige Texte. Unterstützt Platzhalter, Eingabetypen (Text, Zahl, E-Mail, Passwort), ValueState-Markierung und Validatoren.
Designer-Attribute
| Attribut | Beschreibung | Default |
|---|---|---|
controlId | Eindeutige ID | automatisch generiert |
width | Breite (CSS-Wert) | – |
value | Aktueller Eingabewert | – |
placeholder | Platzhalter-Text | – |
type | Eingabetyp. Werte: Text, Date, Datetime, DatetimeLocale, Email, Month, Number, Tel, Time, Url, Week, Password | Text |
inputMode | Tastaturmodus auf Mobilgeräten (HTML inputmode). Werte: (leer), none, text, decimal, numeric, tel, search, email, url | – |
valueStateText | Tooltip-Text bei gesetztem valueState | – |
valueState | Status-Hervorhebung. Werte: Error, Warning, Success, Information, None | None |
visible | Sichtbar | true |
editable | Bearbeitbar oder schreibgeschützt | true |
showValueHelp | Wertehilfe-Symbol am Feld anzeigen | false |
valueHelp | Wertehilfe des Feldes: Name der Suchhilfe (On-Premise) bzw. Adresse der Wertehilfe-Entität (Cloud) | – |
valueHelpField | Feld der Wertehilfe, das diese Komponente führt — darüber wird sie als Filter gefüllt und als Ergebnis beschrieben | – |
fontSize | Schriftgröße (CSS-Wert) | – |
color | Vordergrundfarbe (Hex) | – |
backgroundColor | Hintergrundfarbe (Hex) | – |
spanS / spanM / spanL / spanXL | Breite im Grid-Layout | 12 |
ABAP-API
Zugriff über me->get_input( '<controlId>' ).
| Methode | Zweck |
|---|---|
GET_VALUE | Aktuellen Wert lesen |
SET_VALUE | Wert setzen |
GET_PLACEHOLDER | Platzhalter lesen |
SET_PLACEHOLDER | Platzhalter setzen |
SET_EDITABLE | Bearbeitbarkeit setzen |
SET_VALUE_STATE | Status-Hervorhebung setzen |
SET_VALUE_STATE_TEXT | Status-Tooltip setzen |
INIT | Eingabe und Status zurücksetzen |
Geerbte Methoden: siehe Control.
SET_VALUE
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_VALUE | String | Neuer Wert |
SET_VALUE_STATE
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_VALUE | String | Konstante aus /mobbuild/cl_value_state (co_none, co_error, co_warning, co_success, co_information) |
SET_VALUE_STATE_TEXT
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_VALUE | String | Tooltip-Text bei aktivem ValueState |
Beispiel: /mobbuild/cl_ex_input
Das Beispiel zeigt zwei Event-Pfade: Eingabe-Validierung beim Event 'onValidText' (Längen-Check) und Übernahme der Eingabe in ein Label bei anderen Events:
abap
METHOD on_pai.
IF me->get_event( )->get_event_key( ) EQ 'onValidText'.
IF strlen( me->get_input( 'txtExample' )->get_value( ) ) > 10.
me->get_input( 'txtExample' )->set_value_state(
/mobbuild/cl_value_state=>co_error ).
me->get_input( 'txtExample' )->set_value_state_text(
'darf nur 10 Zeichen haben' ).
ELSE.
me->get_input( 'txtExample' )->set_value_state(
/mobbuild/cl_value_state=>co_none ).
me->get_input( 'txtExample' )->set_value_state_text( space ).
ENDIF.
ELSE.
DATA(lv_value) = me->get_input( 'txtExample' )->get_value( ).
me->get_label( 'lblMessage' )->set_text( lv_value ).
me->get_input( 'txtExample' )->set_value( space ).
me->set_focus( 'txtExample' ).
ENDIF.
ENDMETHOD.Validatoren statt Custom-Code
Einfache Längen- oder Regex-Prüfungen lassen sich auch über Validatoren ohne ABAP-Code erledigen. Validatoren werden im Designer per Drag-and-Drop unter den Input gehängt.
Events im Designer
Verfügbar im Eigenschaften-Panel → Reiter Ereignisse:
| Event | Auslöser |
|---|---|
onSubmit | Drücken der Entertaste |
onChange | Wert geändert (Verlassen des Felds oder Enter) |
Nächste Schritte
- TextArea – mehrzeiliges Eingabefeld
- Validatoren – Eingabeprüfung ohne ABAP-Code
- Label – beschriftendes Anzeigeelement