General list control properties include adding a Search Part, Detail View, local storage capabilities, headers, footers, and search highlighting among other things.
- Has Detail View
Specify if the List has a 'Detail View' - controls on the UX that are populated with values from the current row of data in the List. The DetailView can be used to display a single record view of the current record in the List. The DetailView can also be used to edit the data in the current row in the List.
- Has Search Part
Specifies if the List as a 'Search Part', controls on the UX that allow the user to enter criteria to filter the records shown in the List.
- Persist data to Local Storage (or Filesystem)
Should the data in the List be saved in Local Storage or File System on the device? This option is typically only checked if you are building a mobile application that can work when you are disconnected from the internet.
- Persist where
Defines where data should be persisted in an application. Data can be persisted to Local Storage or a device's file system (PhoneGap applications only.)
- Do incremental refresh after List is populated
Specify if an incremental refresh should be performed after the List is populated. An incremental refresh will not refresh List rows that have been edited but have not been persisted back to server.
- Persist mode
Defines what data should be persisted to the specified location (either Local Storage or a device's File System.)
- Version number
The version number for the List control's persisted data.
The List control has a read-only property.
- Has 'no records in list' message
A common requirement in a List is to show a custom message if the List has no records. The List control has built-in properties to make this task easy. You can automatically center the message horizontally and vertically in the List.
- Allow de-select
If a row in a List has been selected, and the List allows NULL selection, you can check the 'Allow de-select' property. This will de-select the row (so that no row is shown as selected) when the user click on the selected row a second time.
- Loop navigate
You can check the 'Loop navigate' property in a List to turn on 'loop navigation'. With loop navigation, if the last row in the List is selected and the user presses the 'down' key, focus will go to the first row in the list (if Loop navigate null selection is unchecked) or will be set to NULL (if Loop navigate null selection is checked)
- Display text for NULL values
If your data has NULL values, you can now specify the text to show for the NULL values. For example, you might want to show n/a for null values.
- Custom scroll indicator settings
You can customize the position and appearance of the scroll indicator that is shown when the List is scrolled.
- Custom scroll properties
Specify if the List has custom scroll properties, such as 'snap' (to scroll in discrete amounts), and momentum scrolling. The settings you define here apply to each layout you define (if the List has multiple layouts). You can also define custom settings at the individual layout level.
- Search highlighting
- Drag reorder settings
Settings for defining the drag reorder behavior for the List control.
- Has custom row side-to-side drag behavior
If checked, drag left and drag right behaviors can be added to the rows in the List.
- Has fixed footer
Specify if a footer should be shown below the list. Because the footer is 'fixed' it will not move even if the list is scrolled through. To add a footer first check the Has fixed footer property, then define the Fixed header HTML property that appears. The 'Fixed header style' property will help you style the header.
- Has fixed header
Specifies if a header should be shown above the list. If checked you can also specify the header HTML using the fixed Header HTML property.
- Has row drag reorder behavior
Adds the ability to reorder rows by clicking on the row and dragging it to a new position in the list.
- No records HTML
You can alter the HTML in the no records message using the 'No records HTML' property.
- Row drag settings
Opens the List Row Drag Action Builder for configuring the behavior when the user drags a List row from left-to-right or right-to-left.