Data Lists

The Data List element provides developers with a simple way to produce ordered and unordered lists, using data retrieved from a datasource.

 


About the Data List

The Data List element generates a true HTML ordered or unordered list, using data from its datalayer.  

Creating an Ordered or Unordered List

To add an ordered or unordered list to a report definition, start by adding a Data List element:  

The Data List element is included in the Data Tables folder of the Element Toolbox and context menus. As shown in the example above, it uses a datalayer element to retrieve its data. The Data List element's Ordered attribute determines whether the list is ordered (numbered) or unordered (bulleted).
 

A single List Item element is used beneath the Data List element as a container for the list items, as shown above. Multiple List Item elements may be used but they are not necessary; using more than one can will result in interwoven lists of items.

The element's Class attribute can be set, if desired, to one of the Theme-related Data List classes, which are discussed in the next section. If the attribute is left blank, an unordered list will be shown with black bullets and an ordered list will be shown with decimal numbers.  

Finally, an element is added beneath the List Item to show or represent the data. This can be a Label, as shown above, or an Image or other elements, or several elements. The usual @Data tokens are used to reference data for display and additional style classes can be assigned.

 

Using the Data List with a Theme

When you assign a Theme to a Logi application, special standard classes for use with the Data List and List Item elements are made available. For more information, see Themes.
 

As shown above, you can assign these classes to either the Data List or List Item elements' Class attribute (either one, not both). When the Data List is created as an unordered list, the ThemeUL... classes, shown above, can be used to set the shape of the bullet. When the Data List is created as an ordered list, the ThemeOL... classes can be used to set the style of the numbering. This table lists the classes and their effects:
 

Class

Effect
ThemeOLDecimal
ThemeOLLowerAlpha
ThemeOLLowerRoman
ThemeOLUpperAlpha
ThemeOLUpperRoman
ThemeULCircle
ThemeULDisc
ThemeULNone
ThemeULSquare