# 级联选择

一次选择多个相关联的项。

# 概念说明

# 属性

组件通用属性请参见组件通用说明

# 级联选择

  • 数据源:数据列表,支持直接放置多层的数据源也支持通过单层的数据和父节点字段名子节点字段名构建树形,多层列表数据源示例如下:

    [
        { text: '理学', value: '理学', children: [
            { text: '物理学', value: '物理学', children: [
                { text: '理论物理', value: '理论物理' },
                { text: '凝聚态物理', value: '凝聚态物理' },
                { text: '材料物理', value: '材料物理' },
            ] },
            { text: '数学', value: '数学', children: [
                { text: '基础数学', value: '基础数学' },
                { text: '计算数学', value: '计算数学' },
                { text: '应用数学', value: '应用数学' },
            ] },
            { text: '化学', value: '化学' },
        ]},
        { text: '工学', value: '工学', children: [
            { text: '计算机科学与技术', value: '计算机科学与技术', children: [
                { text: '计算机系统结构', value: '计算机系统结构' },
                { text: '计算机软件与理论', value: '计算机软件与理论', disabled: true },
                { text: '计算机应用技术', value: '计算机应用技术' },
            ] },
            { text: '软件工程', value: '软件工程', disabled: true },
            { text: '机械工程', value: '机械工程', children: [
                { text: '机械制造及其自动化', value: '机械制造及其自动化' },
                { text: '机械电子工程', value: '机械电子工程' },
                { text: '机械设计及理论', value: '机械设计及理论', disabled: true },
                { text: '车辆工程', value: '车辆工程', disabled: true },
            ] },
        ] },
    ]
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
  • 数据类型:集合类型每一元素的数据类型。
  • 文本字段名:集合的元素类型中,用于显示文本的属性名称。
  • 值字段名:集合的元素类型中,用于标识选中值的属性。
  • 子节点字段名:树形数据子节点字段名,默认为children。
  • 父节点字段名:当数据源为平铺数据时自动生成级联数据的节点字段名,重要:值字段名需要一起配置。
  • 值:选择器的值。
  • 选择框占位符:搜索框为空时提示文本。
  • 触发方式:触发方式。
  • 可筛选:是否可以过滤(搜索),开启将会显示搜索框。
  • 可清空:开启并在输入框有内容时会显示清除按钮。
  • 只显示最后一项:定义是否显示完整的路径,ture时只显示最后一项。
  • 禁用:禁用选择器。
  • 弹出状态:切换弹出/关闭状态。
  • 自动获取焦点:是否自动获取焦点。
  • 宽度:设置级联框宽度大小。
  • 高度:设置级联框高度大小。

# 事件

事件名 触发条件
输入时 选择某一项时触发
选择后 选择某一项时触发
获得焦点 获得焦点时触发
失去焦点 失去焦点时触发
清空后 清空后触发

# 样式

样式说明请参见组件通用说明

上次更新: 2023年06月15日