Open topic with navigation
The Selection List renders a dropdown list or a list box, depending on the size specified. You can create the option list from content entered directly in this dialog, as shown below, or you can generate the list from a custom query, a ColdFusion expression, or from Element, Metadata, or Form data. You can also source the list from the Groups defined in CommonSpot. The source type you choose determines which other options are available for rendering the list.
See Edit Form Field for a description of Standard Properties and Security tab fields for this and other field types. Specifics for completing Other Properties for the Selection List field are described below.
These options display for multiple checkbox, radio button, and selection list field types to give you choices for sourcing existing content for your lists.
Value List - Creates the option list from the values you enter in the Option List field as shown above. Enter a comma-delimited list with no spaces.
For Selection Lists ONLY: Using this option for Selection Lists also gives you the option of automatically appending an "Other" field to the list, for free-form text entry when list options do not apply. If you allow multiple selections for your list, you can also conditionally show/hide fields, as described below.
Custom Query: Creates the option list from the results of the query you enter, for the datasource you specify. For example, use this option to source a list of existing titles, as shown below for books.
CommonSpot User Groups: Generates the list of CommonSpot groups defined for this site, like the one shown below.
ColdFusion Expression: Click to display the Enter ColdFusion Expression dialog to generate a list matching the criteria you define. The expression you enter for option lists must resolve to simple values within a comma-delimited list (no spaces). See Enter ColdFusion Expression in the Elements Reference for details.
Custom Element/Metadata/Simple Form Data: Displays an option to generate the list dynamically from data contained in the Custom Element, Metadata Form, or Simple Form that you select. Click to display the Option List Source dialog.
Multiple: Enables/disables choosing more than one option in the list. When multiple selection is set to No, the option to show/hide list items is enabled, as described below.
Select Option: Places a --Select-- option in the list and makes the field required. Cannot be used with a multiple selection drop-down list.
Allow Other Values: Enables/disables appending a free-form text field for allowing custom values when other Selection List options don’t apply.
Size: Sets the number of visible options. Defaults to 1, to show the first option. Accepts any positive integer. If the value of the size attribute is greater than 1, but lower than the total number of options in the list, the browser adds a scroll bar to indicate that there are more options. If the Multiple option is enabled, defaults to 4. Required.
Show/Hide Fields: Displays only when Option Source is Value List and Multiple is set to No. Allows you to create rules to show/hide other fields within this form based on option selection. Use this to conditionally hide or show/make required other fields. Click Add New to create new rules for fields. Click Edit/Delete to modify or remove existing rules.
Cookie Field: This option is available for Custom Element form fields, simple forms, and metadata forms. It enables pre-populating fields from stored cookie values. Use this field to auto-complete forms containing fields that were completed in other forms. For example, once a user enters name, city, state, etc. in one form, fields requesting these values are prepopulated in the next form. You can use this feature for Text, Selection List, Multi-checkbox, Checkbox, Email, and Radio Button fields.
Default Value: The value that is populated and displayed within the Custom Element. The field displays either the default value only or is blank and cannot be updated or changed. Setting a default value is an option for all Custom Element field types except for Checkbox, Image, Tree Control, Formatted Text Block, and Date.
You can download PDF versions of the Content Contributor's, Administrator's, and Elements Reference documents from the support section of paperthin.com (requires login).
Sites upgrading from versions earlier than release 6.0 should review the following (from the support section of paperthin.com - requires login):
For technical support:
Open topic with navigation