Role selector

TheRole selector enables you to display a list of all existing roles defined in your website. You can use the selector in the frontend or backend of your site. For example, you can use the selector on a page or in a widget designer. For more information about roles in Sitefinity CMS, see Overview: Roles.

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

Single item selection:

HTML+Razor
<sf-list-selector sf-role-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:

HTML+Razor
<sf-list-selector sf-role-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.

Attribute

Description

sf-selected-item-id

Single select only. Stores the ID of the selected item. 

sf-selected-item 

Single select only. Stores the serialized information of the selected item.

sf-selected-ids

Multi select only. Stores the IDs of the selected items. 

sf-selected-items

Multi select only. Stores the serialized information of the selected items. 

sf-provider

Configures the provider to use when retrieving the items to display.

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?