For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/cascader.md.
v0.0.57
  • 简体中文
  • Cascader

    数据录入@rockshin/tao-ui

    通过搜索、多选或独立面板,从层级选项中选择完整路径。

    每个示例都可以独立复制运行。带设备预览的示例可通过工具栏切换桌面与手机宽度。

    尺寸支持 small、medium、large;兼容别名 middle 与 medium 使用相同尺寸。

    窄于 576px 时自动使用底部抽屉;可用 mobile 强制选择展示方式,mobileTitle 指定抽屉标题。手机端单选即时提交,多选点击 Done 后提交,关闭则取消本次修改。桌面端 hover 时清除按钮替换箭头,触屏始终显示清除按钮。

    示例

    选择完整路径

    选中值按顺序包含路径中的各级 value。

    Asia / China / Shanghai
    TSX

    受控路径与展示

    displayRender 可以缩短展示文字,同时在状态中保留完整路径。

    Tokyo

    asia / japan / tokyo

    TSX

    选择多条路径

    多选模式提供联动复选框;SHOW_CHILD 展示已选叶子路径。

    TSX

    选择中间层级

    changeOnSelect 允许选择中间路径;本例通过鼠标悬停展开下一列。

    Choose a continent, country or city
    TSX

    映射自定义字段

    通过字段映射直接使用已有业务数据。

    Choose a region
    TSX

    按需加载下一列

    此处用本地延迟模拟请求。未加载的父节点设置 isLeaf:false,加载后更新 options。

    Load cities
    TSX

    独立面板

    Cascader.Panel 直接展示级联列,不使用输入触发器。

    TSX

    手机底部抽屉

    在手机模式下通过底部抽屉选择三级路径,级联列超出可用宽度时可以横向滚动。

    单选在选中路径时立即生效。使用 multiple 时,抽屉里的更改在点击「完成」后才应用。从 0.0.49 起,组件会跳过确认前被移除或禁用的新选路径,保留此前已经提交且用户仍保留选中的路径。

    390 × 640
    TSX

    API

    CascaderPanel

    属性说明类型默认值

    Cascader

    属性说明类型默认值
    mobileUse a bottom drawer. Automatically enabled below 576px.boolean | undefined-
    mobileTitleDrawer title; defaults to the field label, then localized selection text.ReactNode-