Selection

A selection field is a form element that lets you select one or more items from the scrollable list and send your selection to the server when you are submitting the form. Selection fields usually contain numerous options and depending on the settings, you can either limit the selection to one item or choose multiple items, by holding the Ctrl key while selecting them with a mouse or an Arrow key on your keyboard.

To insert a selection field into a document in CKEditor, place the cursor inside the form element and press the Selection Field toolbar button. The Selection Field Properties dialog window that will open lets you set the name of a selection field as well as the number and content of available options.

Selection Field Properties dialog window in CKEditor

Below is an overview of all Selection Field Properties dialog window elements:

• Name – the name of the selection field element (name attribute).
• Value – the value of the selection field element (value attribute). This option is filled in automatically when you set one of the items as a selected value.
• Size – the number of rows of the selection field that are visible by default (size attribute). If the selection field contains more items, a scrollbar will appear.
• Available Options – this section contains the options that the user will be able to choose from the selection field.
  • Text – the label of the selection field option.
  • Value – the value of the selection field option submitted to the server.
  • Add – adds an option to the selection field.
  • Modify – modifies a selected option.
  • Up – moves an option one row up the selection field.
  • Down – moves an option one row down the selection field.
  • Set as selected value – sets an option as selected by default.
  • Delete – deletes a selected option.
  • Allow multiple selections – lets the user select more than one option from the selection field.

Once you configure the selection field and click the OK button, the selection field will be visible in CKEditor editing area.

A selection field with one option selected added to a form in CKEditor

Return to editing tools