The list elements

Last updated Monday, October 9, 2017 in Sitecore Experience Platform for Content Author, Marketer
Keywords: Web forms

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:

Dropdown list

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.

List items

Static or Dynamic

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

Select datasource

Click Picture 4 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.

List box

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 Picture 3 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.

Checkbox list

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 Picture 2 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.

Radio button list

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 Picture 1 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.

Send feedback about the documentation to docsite@sitecore.net.