You use the List widget to display lists with list items that you created previously.
PREREQUISITES: You created at least one list with at least one list item in it. For more information, see Lists.
Select lists to display
After you placed the List widget on your page, click the Edit button in the upper-right corner of the widget. In the Edit window, you can configure the following:
Which lists to display?
A custom selection of Lists is displayed.
To select one or more Lists you want to display, click the Select button.
Filter list items by...
Narrow down list items displayed by using:
Sort list items
By default, list items are ordered in accordance with Sitefinity CMS backend list options view. You can select a different sorting criterion:
- Last published
- Last modified
- By Title (A-Z)
- By Title (Z-A)
- As set manually
- As set in Advanced mode
To sort the list items by property that is not defined in the sort dropdown menu, you must add a new sorting expression in the designer’s Advanced mode. For example, to sort list items using the Content property of list item, navigate to Advanced » Model and, for SortExpression, add Content ASC. As a result, in the sort dropdown menu, the As set in Advanced mode option is selected by default.
Select the template you want to use to list list items on the webpage.
Select one of the following:
- Simple list
The system displays all items, grouped in lists. This is a list of the titles of the list items, which cannot be clicked.
- Expanded list
The system displays all items, grouped in lists. Below each item, the system displays its content.
- Expandable list
The system displays all items, grouped in lists. This is a list of the titles of the list items. When you click a list item, the item's content is displayed.
- Anchor list
The system displays all items, grouped in lists. This is a list of the titles of the list items. Below the list the system displays the content of the items. When you click an item, the system opens its content.
- Page list
The system displays all items, grouped in lists. Thus, this is a list of the titles of the list items. When you click an item, the system opens its content on a separate page.
List item details
Select the template you want to use to display list item's details on the webpage.
Expand More options section to specify CSS file names and apply additional CSS classes to the Lists widget.
In Advanced settings, you specify individual properties of the widget:
Gets the template you selected in the List item details dropdown menu.
rel="canonical" metatag to list items. For more information, see Locations of content items: Canonical URLs.
Gets the template you chose in the List items template dropdown menu.
Model settings display all properties directly bound to the List widget model. Access these properties by clicking the Model button in Advanced settings.
||Gets and sets an additional CSS class to the detail view of a list item.
||Filters lists items based on an additional filter expression.
||Gets and sets an additional CSS class to the list view.
||If you have more than one providers added, you can use a lists providers different than the default one. To do this, specify the name of this provider.
NOTE: If you leave this property value empty, the default lists provider is used.
||In case lists items are filtered based on a date, tags, or categories, the IDs of the selected filter criteria are serialized and populated in that field.
||In case lists items are items you specifically selected, the IDs of the selected lists items are serialized and populated in that field. For example: ["3f47d0b8-2d22-6e58-888c-ff0000bfc4e0"]
||Adds additional sorting expression for the lists items. The default value is Ordinal ASC.
||Gets or sets the URL key prefix. Used when building or evaluating URLs for paging and filtering.