Skip to content

Cascader

Multi-level linked selection supporting submission at any level and path display.

Basic Usage

Basic usage

Click to open the multi-level panel and drill down level by level until a leaf node is submitted.

Select & Submit

Select to submit (change-on-select)

With change-on-select enabled, clicking an option at any level (including nodes with children) immediately submits the current path.

Preset Path

Preset value (path array)

value is a JSON array holding the selected value of each level; it is displayed joined as "Zhejiang / Hangzhou".

Disabled

Disabled

Events

Selection events

Listen to oas-change; detail.value is the full path array:

API

Attributes

AttributeDescriptionTypeDefault
change-on-selectSubmit when selecting any levelboolean
disabledDisabledboolean
optionsCascade options, JSON array, supports children / disabledCascaderOption[] | string[]
placeholderPlaceholder text
show-all-levelsWhether to show the full path (reserved in the current version; display is always the full path)
valuePath array (JSON), e.g. ["zj","hz"]string[]

Events

EventDescription
oas-changeSelection change, detail: { value } (path array)