Start of Content Area

Background documentation RowRepeater  Locate the document in its SAP Library structure

A RowRepeater is used to display UI elements specified in the Element (ROW_ELEMENTS) aggregation in a list. Each row in a RowRepeater looks the same since each row consists of the same UI elements, and only the individual rows contain different content.

A RowRepeater is bound to the dataSource of multiple context nodes. For each element in the context, a row is displayed in the RowRepeater.

The ROW_ELEMENTS define the structure of a row in the list.If the element is a TransparentContainer with MatrixLayout, the matrix data is assigned in the grids of the RowRepeater. You can use the vGutter property of the matrix data to attain additional padding and display vertical separators. Otherwise standard values are used for the layout properties.

Caution

The accessibility of the RowRepeater can only be ensured if the RowElements, as mentioned above, are TransparentContainers with a MatrixLayout in which no other container type UI elements (TransparentContainer, Tray, Group, and so on) are nested.

Furthermore, accessibility is only possible if a meaningful rowDescription has been created.

Note

The RowRepeater is recommended for layouts that are repeated vertically. For example, the shopping basket shown below.

You should use the Table UI element for single-line tabular data.

Caution

The use of the Table UI element in the TablePopin and RowRepeater UI elements is not supported.

Within a RowRepeater, complex UI elements such as Table, Tree, GAC*, ViewContiner, InteractiveForm, Gantt, Network, Group, and Tray are not supported.

Example of the Visual Display

This graphic is explained in the accompanying text

 

Runtime Class

CL_WD_ROW_REPEATER

 

Properties in the View Designer

Name

Type

Initial Value

Bindable

id

STRING

(automatic)

No

accessibilityDescription

Translatable text

 

Yes

contextMenuBehaviour

WDUI_CONTEXT_MENU_BEHAVIOUR

inherit

No

contextMenuId

WDY_MD_UI_ELEMENT_REFERENCE

 

No

dataSource

Context node

 

Mandatory

design

WDUI_ROW_REPEATER_DESIGN

transparent

Yes

enabled

WDY_BOOLEAN

true

Yes

firstVisibleRow

I

0

Yes

rowDescription

Translatable text

 

Yes

tooltip

Translatable text

 

Yes

visible

WDUI_VISIBILITY

visible

Yes

visibleRowCount

I

10

Yes

width

STRING

 

Yes

 

Aggregations in the View Designer

Name

Cardinality

Type

Element

0..n

UIElement

Note

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

        UIElement

        ContextMenuProvider

        ViewElement

Dynamic Programming

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

Dynamic Programming of Properties

View Designer Name

Runtime Name

Type

accessibilityDescription

ACCESSIBILITY_DESCR

WDY_MD_TRANSLATABLE_TEXT

contextMenuBehaviour

CONTEXT_MENU_BEHAVIOUR

WDUI_CONTEXT_MENU_BEHAVIOUR

 contextMenuBehaviour: inherit

CL_WD_ROW_REPEATER=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT

 contextMenuBehaviour: provide

CL_WD_ROW_REPEATER=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE

 contextMenuBehaviour: suppress

CL_WD_ROW_REPEATER=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS

contextMenuId

CONTEXT_MENU_ID

WDY_MD_UI_ELEMENT_REFERENCE

dataSource

DATA_SOURCE

OBJECT

design

DESIGN

WDUI_ROW_REPEATER_DESIGN

design: alternating

CL_WD_ROW_REPEATER=>E_DESIGN-ALTERNATING

design: transparent

CL_WD_ROW_REPEATER=>E_DESIGN-TRANSPARENT

enabled

ENABLED

WDY_BOOLEAN

firstVisibleRow

FIRST_VISIBLE_ROW

I

rowDescription

ROW_DESCRIPTION

WDY_MD_TRANSLATABLE_TEXT

tooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

visible

VISIBLE

WDUI_VISIBILITY

visible: none

CL_WD_ROW_REPEATER=>E_VISIBLE-NONE

visible: visible

CL_WD_ROW_REPEATER=>E_VISIBLE-VISIBLE

visibleRowCount

VISIBLE_ROW_COUNT

I

width

WIDTH

STRING

 

Dynamic Programming of Aggregations

View Designer Name

Runtime Name

Cardinality

Element

ROW_ELEMENTS

0..n

Example

You can find examples of this UI element in the WDR_TEST_EVENTS component.

 

 

End of Content Area