Sitecore Experience Platform

The list elements 

Abstract

Use the default list elements for drop-down lists, list boxes, check boxes, and radio button lists.

Many forms use lists to gather data. The Forms application contains default list elements for drop-down lists, list boxes, check boxes, and radio button lists. A list item can connect to existing data, or it can display a fixed value that you enter when you create the item.

This topic describes the following list elements and their settings:

Use the Dropdown list element to display a list of options where a contact can only select one of the options.

Section

Item

Description

Details

Label

Caption that tells contacts what information a particular form field is asking for.

Field name

Name of the element. Always use meaningful names for the Field name. The Field name is the actual Item name for the Sitecore definition item for the form field.

List items

Static or Dynamic

Determines whether the list items connect to existing data or to a fixed value.

Select datasource

Click 991AB1126EBB4529B25C1A51EFF1E44A.png to select a data source. In the Select a data source for the control dialog box, navigate to the item on your website that contains the subitems corresponding to the field values that you want to display. Select the relevant item, and then click Select.

Drop list item 1 label

Specifies the first drop list item.

Drop list item values

Determines the value that is saved to the database. The options are Same as label or Customized.

Value

Sets the list box value that you want to save in the database when you select Customized in the Drop list box item values field.

Default chosen list item

The list item that is preselected by default.

Empty list item at top of list

Indicates whether the list starts with an empty line. The options are Yes or No.

Validation

Field importance

Indicates whether the visitor must fill in the field. The options are Optional or Mandatory.

Styling

CSS class

Defines the CSS class of the field.

CSS class for label

Defines the CSS class of the label.

Advanced settings

Allow save

Enables or disables saving the filled-in field data upon form submission.

Use the List box element to display a list of options where a contact can select any number of choices, including zero, one, or several.

Section

Item

Description

Details

Label

Caption that tells contacts what information a particular form field is asking for.

Field name

Name of the element.

List items

Static or Dynamic

Determines whether the list items connect to existing data or to a fixed value.

Select datasource

Click 28EDF19EE3CB4FACA815DABF873C5732.png to select a data source. In the Select a data source for the control dialog box, navigate to the item on your website that contains the subitems corresponding to the field values that you want to display. Select the relevant item, and then click Select.

List box item item 1 label

The value of the first list box item.

List box item values

Determines the value that is saved to the database. The options are Same as labels or Customized. For example, when you use different language versions of your form, you can decide to save the original language values to the database.

Value

Sets the list box value that you want to save in the database when you select Customized in the List box item values field.

Default chosen list item

The list item that is preselected by default.

Selection Mode

Indicates whether only a single item or multiple items can be selected from the list at one time. The options are Single or Multiple.

Rows

The number of rows.

Validation

Field importance

Indicates whether the contact must fill in the field. The options are Optional or Mandatory.

Styling

CSS class

Defines the CSS class of the field.

CSS class for label

Defines the CSS class of the label.

Advanced settings

Allow save

Enables or disables saving the filled-in field data upon form submission.

Use the Checkbox list element to display a list of options where the contact can select any number of choices, including zero, one, or several.

Section

Item

Description

Details

Label

Caption that tells contacts what information a particular form field is asking for.

Field name

Name of the element.

List items

Static or Dynamic

Determines whether the list items connect to existing data or to a fixed value.

Select data source

Click 56A48D621FFF44EDA7E9E595B0EC5DA7.png to select a data source. In the Select a data source for the control dialog box, navigate to the item on your website that contains the subitems corresponding to the field values that you want to display. Select the relevant item, and then click Select.

Checkbox 1 label

The value of the first check box item.

Checkbox values

Determines the value that is saved to the database. The options are Same as labels or Customized. For example, when you use different language versions of your form, you can decide to save the original language values to the database.

Value

Sets the list box value that you want to save in the database when you selected Customized in the Checkbox values field.

Selected checkboxes

The list item that is preselected by default.

Validation

Field importance

Indicates whether the contact must fill in the field. The options are Optional or Mandatory.

Styling

CSS class

Defines the CSS class of the field.

CSS class for label

Defines the CSS class of the label.

Advanced settings

Allow save

Enables or disables saving the filled-in field data upon form submission.

Use the Radio button list element to add a field to your form that displays a list of two or more options that are mutually exclusive and where the user must select one option.

Section

Item

Description

Details

Label

Caption that tells contacts what information a particular form field is asking for.

Field name

Name of the element.

List items

Static or Dynamic

Determines whether the list items connect to existing data or to a fixed value.

Select datasource

Click 15A17578A5354C528FC52A4482B183CF.png to select a data source. In the Select a data source for the control dialog box, navigate to the item on your website that contains the subitems corresponding to the field values that you want to display. Select the relevant item, and then click Select.

Radio button 1 label

The value of the first list item.

Radio button values

Determines the value that is saved to the database. The options are Same as labels or Customized.

Selected radio button

The list item that is preselected by default.

Validation

Field importance

Indicates whether the contact must fill in the relevant field. The options are Optional or Mandatory.

Styling

CSS class

Defines the CSS class of the field.

CSS class for label

Defines the CSS class of the label.

Advanced settings

Allow save

Enables or disables saving the filled-in field data upon form submission.