4.0 Picklist Concept: Developer
Introduction
You create Picklists to supply a standard set of text values that editors can use in their Content Items. Often, this is to provide a safe way to configure the styles and metadata you define in your Components.
Picklist overview
A Picklist is a list of values that can be used in a Content Item
You can create a list of text values known as a Picklist and use it as a Variable Type in your Components. This gives content editors a selection of values to choose from when editing Content Items.
For example, you might create a Picklist containing theme colours, allowing content editors to quickly choose the appropriate colour values of a Content Item – and to see all of the options available.
The items of a Picklist are known as Picklist Items.
Picklist Items must be text values.
Picklists make it easy to reuse and standardise the values used in Content Items.
Conceptual Diagram
Single and Multi Select Picklists
Picklist Variables must be configured as Single Select or Multi Select, which determines whether content editors can select one or several Picklist Items. When multi-select is configured, a delimiter must also be configured to join the chosen Picklist Items together into a final string value for the Content Item.
The following diagram shows how:
Content editors can only choose one value from a Single Select Picklist
Content editors can choose multiple values from a Multi Select Picklist
Picklists on a Page
In the following diagram, a content editor selects Picklist Items which change the styles and therefore the colours displayed on a Page.
Warnings
Picklists have been created for configuring non-displaying Content Items, such as style classes. Therefore, Picklist Items are not localisable.
User journeys
Glossary
See the Glossary for more information.