List

Listenanzeige mit beliebig vielen Items. Im Gegensatz zur Table ohne Spalten-Schema – jedes Item hat einen Titel, eine optionale Beschreibung, ein Icon sowie eine Zusatzinformation (info) mit eigenem Status.

Designer-Attribute

Attribut	Beschreibung	Default
controlId	Eindeutige ID	automatisch generiert
noDataText	Text bei leerer Liste	–
showNoData	Hinweistext anzeigen, wenn keine Einträge vorhanden sind	true
headerText	Listen-Überschrift	–
mode	Darstellungsmodus. Werte: None, SingleSelect, SingleSelectLeft, SingleSelectMaster, MultiSelect	None
visible	Sichtbar	true
spanS / spanM / spanL / spanXL	Grid-Layout	12

StandardListItem

Attribut	Beschreibung	Default
controlId	Eindeutige ID der Komponente	automatisch generiert
key	Eindeutiger Schlüssel	–
title	Erste Zeile	Title text
Description	Zweite Zeile unter dem Titel	Description text
icon	SAP-Icon-URL (z.B. sap-icon://home)	sap-icon://picture
iconInset	Icon mit Innenabstand	true
highlight	Farbige Markierung am Zeilenrand. Werte: Information, Warning, Error, None, Success	None
info	Zusatzinformation rechts	[info]
infoState	Status der Zusatzinformation. Werte: Error, Warning, Success, Information, None	Error
infoStateInverted	Zusatzinformation invertiert darstellen	true
wrapping	Zeilenumbruch	true
wrapCharLimit	Zeichenlimit für den Umbruch	50
selected	Ausgewählt	false
visible	Komponente sichtbar	true

ABAP-API

Zugriff über me->get_list( '<controlId>' ).

Methode	Zweck
ADD_LIST_ITEM	Item anhängen (Struktur ty_list_item)
GET_ITEMS	Tabelle aller Items
GET_ITEM	Item nach key
GET_SELECTED_ITEMS	Tabelle der selektierten Items
REMOVE_ITEM	Item nach key entfernen
ADD_LIST_ITEMS	Mehrere Einträge hinzufügen
GET_HEADER_TEXT / SET_HEADER_TEXT	Überschrift
GET_MODE / SET_MODE	Auswahlmodus bzw. Darstellungsmodus
GET_NO_DATA_TEXT / SET_NO_DATA_TEXT	Text bei leerer Liste
GET_SHOW_NO_DATA / SET_SHOW_NO_DATA	Hinweis bei leerer Liste anzeigen
ITEMS_COUNT	Anzahl Einträge
REMOVE_ALL_ITEMS	Alle Einträge entfernen

Item-Struktur /mobbuild/cl_list=>ty_list_item:

Feld	Typ	Bedeutung
key	String	Eindeutiger Schlüssel (Pflicht)
title	String	Erste Zeile
description	String	Zweite Zeile (Designer-Attribut Description)
icon	String	SAP-Icon-URL
iconinset	BOOLE_D	Icon mit Innenabstand
highlight	String	Farbige Markierung am Zeilenrand (None, Information, Warning, Error, Success)
info	String	Zusatzinformation rechts
infostate	String	Status der Zusatzinformation (None, Error, Warning, Success, Information)
infostateinverted	BOOLE_D	Zusatzinformation invertiert darstellen
wrapping	BOOLE_D	Zeilenumbruch
wrapcharlimit	Integer	Zeichenlimit für den Umbruch
selected	BOOLE_D	Ausgewählt
visible	BOOLE_D	Sichtbarkeit

Ein leerer key löst eine Ausnahme aus; ein vorhandener Eintrag mit demselben key wird ersetzt. Nicht befüllte Felder werden mit ihrem Initialwert übertragen – setzen Sie deshalb mindestens visible = abap_true, sonst bleibt das Item ausgeblendet.

Geerbte Methoden: siehe Control.

Beispiel: /mobbuild/cl_ex_list

Das Beispiel hängt beim Event 'Add' einen neuen Eintrag an und liest einzelne Items, alle Items sowie die selektierten Items aus:

METHOD on_pai.

  DATA(lo_event) = me->get_event( ).
  DATA(lo_list)  = me->get_list( 'listExample1' ).

  IF lo_event->get_event_key( ) EQ 'Add'.

    DATA(ls_list_item_1) = VALUE /mobbuild/cl_list=>ty_list_item(
      key         = 'item_1'
      title       = 'item_1_title'
      description = 'item_1_description'
      visible     = abap_true
    ).

    lo_list->add_list_item( ls_list_item_1 ).

  ENDIF.

  DATA(lt_item)           = lo_list->get_item( iv_key = 'listItem1' ).
  DATA(lt_items)          = lo_list->get_items( ).
  DATA(lt_selected_items) = lo_list->get_selected_items( ).

ENDMETHOD.

Events im Designer

Event	Auslöser
onChange	Auswahl eines Items geändert

Nächste Schritte

• Table – tabellarische Daten mit Spaltenschema