# BufferedList

The BufferedList component is the base layout component for almost all list-based components in the Core Engine.

The advantage of using a buffered list as the displaying component is the possibility to reuse ItemRenderers. The buffered list does not create a separate ItemRenderer for each data set, but only as many as are required.
For example, if a list is scrolled, the data in the ItemRenderers is only updated instead of creating new ItemRenderers. That in turn leads to a better performance.

# Properties

  • Parent: Component

  • Element tag: cm4ap-buffered-list

# Parameter

# Parameters in the Layout

Name Type and Values Description
grid Type: boolean
Default value: false
Defines whether the BufferedList should be displayed as a tile view. All other settings regarding the tile view are made via the zoomActor (see below).
itemRenderer Type: string or ListItemRendererFactory
Default value: ListItemRendererFactory
The class name of the ListItemRenderer component to be used as the ItemRenderer. Must be either the ListItemRenderer component or a component based on it.
listActor Type: ListActor The data held in the ListActor is represented by the BufferedList.
selectionActor Type: SelectionActor The SelectionActor manages selected or marked objects. It is used by the BufferedList to make list entries selectable or markable (more details).
zoomActor Type: ZoomActor Only if grid = true
If a ZoomActor is passed to the BufferedList, it is able to adjust the tile size depending on the information in the ZoomActor (more details).

# Selecting and Marking

In order for object selections and markings to be visible to system users, an ItemRenderer is required that supports this. The ListItemRenderer component is such an ItemRenderer.

All components based on the ListItemRenderer should be checked individually to see if they override the functionality.

# Tile Zooming

By default, each tile is 200 px x 200 px. With each zoom in or out the size changes by 10 px in both dimensions. The default size of a tile can be overridden by the ItemRenderer used.

Request missing documentation