Page selector

This article demonstrates how to add a Page selector in widget's designer view.

To add a Page selector, in your DesignerView.YourView.cshtml file, place one of the following tags anywhere in the HTML code:

Single item selection:

Razor
<sf-list-selector sf-page-selector sf-multiselect="false" sf-sortable="true"
                                 sf-provider="properties.ProviderName.PropertyValue"
                                 sf-selected-item-id="properties.SelectedItemId.PropertyValue" 
                                 sf-selected-item="properties.SelectedItem.PropertyValue"></sf-list-selector>

Multiple items selection:

Razor
<sf-list-selector sf-page-selector sf-multiselect="true" sf-sortable="true"
                                sf-provider="properties.ProviderName.PropertyValue"
                                sf-selected-ids="properties.SelectedItemIds.PropertyValue" 
                                sf-selected-items="properties.SelectedItems.PropertyValue"></sf-list-selector>

The values of the attributes are scope properties that you define in the MVC widget controller.

AttributeDescription
sf-selected-item-idSingle select only. Stores the ID of the selected item.
sf-selected-itemSingle select only. Stores the serialized information of the selected item.
sf-selected-idsMulti select only. Stores the IDs of the selected items.
sf-selected-itemsMulti select only. Stores the serialized information of the selected items.
sf-providerConfigures the provider to use when retrieving the items to display.
sf-masterDefines whether the selector displays pages and their statues, such as Draft, Locked, and so on, or only published pages. By default, the Page selector displays master items, that is, all pages, independently of their status. To display only live pages, set the sf-master="false".
Want to learn more?
Enhance your Sitefinity skills by enrolling in free training sessions. Become Sitefinity certified through Progress Education Community to strengthen your professional credentials.
New to Sitefinity?