Configuring the properties of widget components

This section describes how to configure the properties of components that have been added to a widget in the properties panel builder.

When you have added a UI component to a widget in the properties panel builder, you can configure its properties. To configure components in a widget, select the widget, and click the edit icon @ at the bottom of the properties panel builder. Click on the settings icon V of the component you want to configure.

The following table describes the components that can be added to a widget and the settings in each that can be configured.

Component	Property	Default	Comment
Data	Dimensions Min Dimensions Max Measures Min Measures Max	0 0 1 1	Set the Min values to be greater than zero if you want to allow a dimension/measure to be added to the widget. By default, the data component allows one measure to be added. Adjust the Min and Max values as required.
Sorting			This component is blank until you add at least one dimension or a measure to the data component. When two or more dimensions and/or measures have been added, you can reorder the sorting of data in the widget by dragging dimensions/measures to a different position, just as in the properties panel in standard visualizations.
Header	Label	Settings	This component provides a name for a subsection under Appearance for you to add UI components found under Items in the available components panel. You must add a header before you can add any of the UI components.
UI components
Input field, Checkbox, Text area, Dropdown list, Radio buttons, Switch	Label Default value Reference Code	Property1 property1 settings.property1	All UI components have the following settings: Label. Change the default label (Property1, Property2, and so on) to something more meaningful to users. Default value field. Free text for Input field and Text area. See descriptions of Checkbox, Dropdown list, Radio buttons, and Switch for their default value settings. Reference and Code. When inserted into the HTML of the widget, the code provides a reference to bind the UI component to the widget. The format is settings.property1. The value of Reference that appears in the code is also used to identify the component in the insert tool.
Input field	Default value		Can be set to an expression.
Checkbox	Default value	False	Set to True or False.
Text area	Rows Max length	3 512
Dropdown list	Options Label Value Default value	No options (Empty) (Empty) No default value	To add options for the user to choose from in the dropdown list in the widget, click Add. For each option there is a Label field and a Value field, which cannot be left empty. Click in the fields to edit. You can then select a default option, if required.
Radio buttons	Options Label Value Default value	Option Option Value Option	By default, there is one radio button with the default label Option and value label Value. To add further radio button options for the user to choose from in the widget, click Add. For each added option there is a Label field and a Value field, which cannot be left empty. Click in the fields to edit. You can then select a different default option, if required.
Switch	Options Label Default value	True False Label true Label false True (Set to the right)	By default, the switch has labels True and False, with value labels Label true and Label False. The default setting can be with the switch to the right or left.