List

Listenanzeige mit beliebig vielen Items. Im Gegensatz zur Table ohne Spalten-Schema – jedes Item hat einen Titel, eine optionale Beschreibung und einen Icon.

Designer-Attribute

Attribut	Beschreibung	Default
controlId	Eindeutige ID	automatisch generiert
mode	None, SingleSelect, SingleSelectMaster, MultiSelect	None
growing	Stufenweises Nachladen	true
growingThreshold	Anzahl Items pro Ladestufe	20
noDataText	Text bei leerer Liste	leer
headerText	Listen-Überschrift	leer
width	Breite (CSS-Wert)	–
visible	Sichtbar	true
spanS / spanM / spanL / spanXL	Grid-Layout	12

Items werden in der Regel zur Laufzeit aus ABAP befüllt.

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
INIT	Auswahl zurücksetzen

Item-Struktur /mobbuild/cl_list=>ty_list_item:

Feld	Typ	Bedeutung
key	String	Eindeutiger Schlüssel
title	String	Titel des Items
description	String	Optionaler Beschreibungstext
visible	BOOLE_D	Sichtbarkeit

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