New version of the Cascader component
A new and improved version of the Cascader component is now available on Retool Cloud and for self-hosted organizations. Retool recommends using the new component, and the legacy version will be deprecated. You can click Upgrade in the Inspector of an existing Cascader component to use the new version.
The new Cascader features:
- The ability to manually add an option list or dynamically map one to existing data.
- A new dropdown look, similar to the Select component.
- New label options (customizeable caption, color, icon).
- Options now support numeric values in addition to string values.
Some additional changes in this version include:
- The
valueof the new Cascader component is thevalueof the selected option. A newvaluePathproperty enables you to have access to the path of values leading to the selected option. - Option values must be unique.
- Like other modern Retool components, values for options need to be unique. If you use the one-click upgrade for Cascaders, duplicate values will have parent values appended to make them unique.
- Like Checkbox Group and Navigation, the data source is expected to be an array of objects with a property that points to its parent. Cascader nests options by parent value.

