Cascader

A combination select and input field to choose a set of values from a multi-level tree. It supports direct input to search for values and can perform validation of required field.

Properties

Available properties for Cascader. You can write JavaScript almost anywhere in Retool to manipulate or read information about components.

NameDescriptionvalue

A list of values in nested order.

displayValue

A list of values in nested order.

structure

A nested array of possible values.

required

Whether the input is required for validation.

onSelect
placeholder

The text to display in the input field when empty.

disabled

Whether user input, interaction, or selection is disabled.

hideClearButton

Whether to hide a button that clears the current value of the input field.

label

The text to display as a label for the input field.

labelMaxWidth

The maximum label width, in px.

labelPlacedOnLeft

Whether the label is positioned to the left of the input field.

tooltipText

The tooltip text to display when the cursor hovers over the help icon.

Events

Events are triggered by user interactions with Cascader. Use event handling to trigger queries or other actions in response to events.

NameDescriptionChange

A user changes the current value.

Methods

Methods for interacting with Cascader. You can write JavaScript almost anywhere in Retool and use methods to manipulate data or components.

NameDescriptionscrollIntoView(options: any)

Scrolls the canvas or parent container so that the selected component appears in the visible area.

clearValue()

Clear the current value.

setValue(value: any)

Set the current value.