List

Overview

The List Web Control is a repeating element to display a collection of data. It can be used in input forms or to display data. The List Web Control iterates over a variable list, displaying a cell for each item on the list. Lists can use Button Cell Web Controls, Simple Cell Web Controls, Checkbox Cell Web Controls, or Radio Cell Web Controls to hold each of the items.

Control Details

Data

The list of data. Each item in the list has its own cell.

Item Name

By default named as item. This property is used within the context of each cell as the current item.

Index Name

By default named index. This is the number value of the current index of the current item, visible within the context of the cell.

Collection Name

By default named items. This is a variable referring to the entire collection of Objects, with the default values set up: items[index] = item.

Cells

Because Lists are generic containers, they can work with any of the cell types:

• Button Cell Web Controls
• Simple Cell Web Controls
• Checkbox Cell Web Controls
• Radio Cell Web Controls

Example 1: Simple House List

A simple List containing the list of houses a service manages:

Create a list control on the page. Populate a list of Houses. Set the data to the list of houses. Add a simple cell and populate the cell with the title and image of the house.