# 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.