Radio Buttons component icon Radio Buttons

The Radio Buttons component provides a choice between two or more options.

Appearance

Design Rendered
Radio Buttons component rendered
Radio Buttons component design

Attributes

Group Name Description

General

ID

This is a unique id for the component.

Label

The label attribute adds a label to the component, if not empty.

Label position

The position of the label, you can choose between Left or Top.

Label tooltip

When it is defined, a question mark icon appears in the component label. When the user hovers over it, it shows this text in a tooltip.

Value

The binding for the component. Use an appropriate expression to bind the component to its value and thus specify where the value is saved read. For example, use {{myVariableName}} to store the value of the component in a variable named myVariableName. Use prefixes to define the scope of the value, e.g., root. for referencing the root case to store the value in or parent. to store the value in the parent work item of the current one. For instance {{root.foo}} stores the value in the root case using a variable named foo. For more information please refer to the Flowable Forms section.

Default value

If a value is not set, the default value is used. Use an appropriate value; e.g., a text, a number, an id or a comma-separated list.

Description

The description attribute additionally adds a description to the component.

Visible

Boolean value or expression specifies whether the component is visible or hidden. This expression might include another value in the same form, for instance, use a checkbox bound to {{showAdditionalFields}} and use the very same expression as the visible attribute to show or hide the component according to the checked state of the checkbox. If you want only to show the component, if the form is not used as the init-form, you can use the expression {{root.id}} which evaluates to true only, if there is a current id which is not the id in a start form.

Ignored

If true the component is hidden and the value is not part of the payload.

Enabled

A Boolean value or expression specifies whether component is enabled or disabled.

Details

Orientation

Specifies the how the items are arranged: Horizontal or Vertical. The default arrangement is vertical.

Text option

If the attribute is not empty an additional ending option named with that string and with a writable text field are added.

Data source

Data source

Specify the data source type: Static, REST, or Master.

Options

If the data source type is Static then specify the options for the selection list. The name is used as the label in the selection list, and the value is used to store the selected element.

Query URL

The REST endpoint URL used to query for the full list of items.

Lookup URL

The REST endpoint URL used to retrieve the item by id.

Path

Where to find the array of items in the REST response, e.g., 'data.users'.

Format

This is an expression used to generate the label for each item. For example, Mr. {{$item.name}} {{$item.surname}}. The expression is evaluated against the current work object. The selected item is available as $item.

Storage

Specifies how the data retrieved by the REST endpoint is stored in the variable. Choose 'ID' if only the ID of the selected entry should be saved in the variable, choose 'Full value' if the whole object should be saved and thus making it possible to display other values of the selected element within the form as well. Pay attention as storing the full value could lead to bloating the variables with unnecessary information depending on the amount of data retrieved by the REST endpoint.

Map to

The attribute of an item into which the value is mapped. For a Static data source value is commonly used as the map to attribute and for a REST data source id is commonly used as the map to attribute.

Documentation

Documentation

Documentation intended to explain concepts of its use for future reference.

Customization

Style class

Stylesheet class name. Add any style classes to be applied to the component for the desired styling and rendering.