• Cascader 级联选择器
    • 基础用法
    • 禁用选项
    • 仅显示最后一级
    • 默认值
    • 选择即改变
    • 动态加载次级选项
    • 可搜索
    • Attributes
    • props
    • Events

    Cascader 级联选择器

    当一个数据集合有清晰的层级结构时，可通过级联选择器逐级查看并选择。

    基础用法

    有两种触发子菜单的方式

    Cascader 级联选择器 - 图1

    只需为 Cascader 的options属性指定选项数组即可渲染出一个级联选择器。通过expand-trigger可以定义展开子级菜单的触发方式。本例还展示了change事件，它的参数为 Cascader 的绑定值：一个由各级菜单的值所组成的数组。

    1. <div class="block">
    2.   <span class="demonstration">默认 click 触发子菜单</span>
    3.   <el-cascader
    4.     :options="options"
    5.     v-model="selectedOptions"
    6.     @change="handleChange">
    7.   </el-cascader>
    8. </div>
    9. <div class="block">
    10.   <span class="demonstration">hover 触发子菜单</span>
    11.   <el-cascader
    12.     expand-trigger="hover"
    13.     :options="options"
    14.     v-model="selectedOptions2"
    15.     @change="handleChange">
    16.   </el-cascader>
    17. </div>
    19. <script>
    20.   export default {
    21.     data() {
    22.       return {
    23.         options: [{
    24.           value: 'zhinan',
    25.           label: '指南',
    26.           children: [{
    27.             value: 'shejiyuanze',
    28.             label: '设计原则',
    29.             children: [{
    30.               value: 'yizhi',
    31.               label: '一致'
    32.             }, {
    33.               value: 'fankui',
    34.               label: '反馈'
    35.             }, {
    36.               value: 'xiaolv',
    37.               label: '效率'
    38.             }, {
    39.               value: 'kekong',
    40.               label: '可控'
    41.             }]
    42.           }, {
    43.             value: 'daohang',
    44.             label: '导航',
    45.             children: [{
    46.               value: 'cexiangdaohang',
    47.               label: '侧向导航'
    48.             }, {
    49.               value: 'dingbudaohang',
    50.               label: '顶部导航'
    51.             }]
    52.           }]
    53.         }, {
    54.           value: 'zujian',
    55.           label: '组件',
    56.           children: [{
    57.             value: 'basic',
    58.             label: 'Basic',
    59.             children: [{
    60.               value: 'layout',
    61.               label: 'Layout 布局'
    62.             }, {
    63.               value: 'color',
    64.               label: 'Color 色彩'
    65.             }, {
    66.               value: 'typography',
    67.               label: 'Typography 字体'
    68.             }, {
    69.               value: 'icon',
    70.               label: 'Icon 图标'
    71.             }, {
    72.               value: 'button',
    73.               label: 'Button 按钮'
    74.             }]
    75.           }, {
    76.             value: 'form',
    77.             label: 'Form',
    78.             children: [{
    79.               value: 'radio',
    80.               label: 'Radio 单选框'
    81.             }, {
    82.               value: 'checkbox',
    83.               label: 'Checkbox 多选框'
    84.             }, {
    85.               value: 'input',
    86.               label: 'Input 输入框'
    87.             }, {
    88.               value: 'input-number',
    89.               label: 'InputNumber 计数器'
    90.             }, {
    91.               value: 'select',
    92.               label: 'Select 选择器'
    93.             }, {
    94.               value: 'cascader',
    95.               label: 'Cascader 级联选择器'
    96.             }, {
    97.               value: 'switch',
    98.               label: 'Switch 开关'
    99.             }, {
    100.               value: 'slider',
    101.               label: 'Slider 滑块'
    102.             }, {
    103.               value: 'time-picker',
    104.               label: 'TimePicker 时间选择器'
    105.             }, {
    106.               value: 'date-picker',
    107.               label: 'DatePicker 日期选择器'
    108.             }, {
    109.               value: 'datetime-picker',
    110.               label: 'DateTimePicker 日期时间选择器'
    111.             }, {
    112.               value: 'upload',
    113.               label: 'Upload 上传'
    114.             }, {
    115.               value: 'rate',
    116.               label: 'Rate 评分'
    117.             }, {
    118.               value: 'form',
    119.               label: 'Form 表单'
    120.             }]
    121.           }, {
    122.             value: 'data',
    123.             label: 'Data',
    124.             children: [{
    125.               value: 'table',
    126.               label: 'Table 表格'
    127.             }, {
    128.               value: 'tag',
    129.               label: 'Tag 标签'
    130.             }, {
    131.               value: 'progress',
    132.               label: 'Progress 进度条'
    133.             }, {
    134.               value: 'tree',
    135.               label: 'Tree 树形控件'
    136.             }, {
    137.               value: 'pagination',
    138.               label: 'Pagination 分页'
    139.             }, {
    140.               value: 'badge',
    141.               label: 'Badge 标记'
    142.             }]
    143.           }, {
    144.             value: 'notice',
    145.             label: 'Notice',
    146.             children: [{
    147.               value: 'alert',
    148.               label: 'Alert 警告'
    149.             }, {
    150.               value: 'loading',
    151.               label: 'Loading 加载'
    152.             }, {
    153.               value: 'message',
    154.               label: 'Message 消息提示'
    155.             }, {
    156.               value: 'message-box',
    157.               label: 'MessageBox 弹框'
    158.             }, {
    159.               value: 'notification',
    160.               label: 'Notification 通知'
    161.             }]
    162.           }, {
    163.             value: 'navigation',
    164.             label: 'Navigation',
    165.             children: [{
    166.               value: 'menu',
    167.               label: 'NavMenu 导航菜单'
    168.             }, {
    169.               value: 'tabs',
    170.               label: 'Tabs 标签页'
    171.             }, {
    172.               value: 'breadcrumb',
    173.               label: 'Breadcrumb 面包屑'
    174.             }, {
    175.               value: 'dropdown',
    176.               label: 'Dropdown 下拉菜单'
    177.             }, {
    178.               value: 'steps',
    179.               label: 'Steps 步骤条'
    180.             }]
    181.           }, {
    182.             value: 'others',
    183.             label: 'Others',
    184.             children: [{
    185.               value: 'dialog',
    186.               label: 'Dialog 对话框'
    187.             }, {
    188.               value: 'tooltip',
    189.               label: 'Tooltip 文字提示'
    190.             }, {
    191.               value: 'popover',
    192.               label: 'Popover 弹出框'
    193.             }, {
    194.               value: 'card',
    195.               label: 'Card 卡片'
    196.             }, {
    197.               value: 'carousel',
    198.               label: 'Carousel 走马灯'
    199.             }, {
    200.               value: 'collapse',
    201.               label: 'Collapse 折叠面板'
    202.             }]
    203.           }]
    204.         }, {
    205.           value: 'ziyuan',
    206.           label: '资源',
    207.           children: [{
    208.             value: 'axure',
    209.             label: 'Axure Components'
    210.           }, {
    211.             value: 'sketch',
    212.             label: 'Sketch Templates'
    213.           }, {
    214.             value: 'jiaohu',
    215.             label: '组件交互文档'
    216.           }]
    217.         }],
    218.         selectedOptions: [],
    219.         selectedOptions2: []
    220.       };
    221.     },
    222.     methods: {
    223.       handleChange(value) {
    224.         console.log(value);
    225.       }
    226.     }
    227.   };
    228. </script>

    禁用选项

    通过在数据源中设置 disabled 字段来声明该选项是禁用的

    Cascader 级联选择器 - 图2

    本例中，options指定的数组中的第一个元素含有disabled: true键值对，因此是禁用的。在默认情况下，Cascader 会检查数据中每一项的disabled字段是否为true，如果你的数据中表示禁用含义的字段名不为disabled，可以通过props属性来指定（详见下方 API 表格）。当然，value、label和children这三个字段名也可以通过同样的方式指定。

    1. <el-cascader
    2.   :options="optionsWithDisabled"
    3. ></el-cascader>
    4. <script>
    5.   export default {
    6.     data() {
    7.       return {
    8.         optionsWithDisabled: [{
    9.           value: 'zhinan',
    10.           label: '指南',
    11.           disabled: true,
    12.           children: [{
    13.             value: 'shejiyuanze',
    14.             label: '设计原则',
    15.             children: [{
    16.               value: 'yizhi',
    17.               label: '一致'
    18.             }, {
    19.               value: 'fankui',
    20.               label: '反馈'
    21.             }, {
    22.               value: 'xiaolv',
    23.               label: '效率'
    24.             }, {
    25.               value: 'kekong',
    26.               label: '可控'
    27.             }]
    28.           }, {
    29.             value: 'daohang',
    30.             label: '导航',
    31.             children: [{
    32.               value: 'cexiangdaohang',
    33.               label: '侧向导航'
    34.             }, {
    35.               value: 'dingbudaohang',
    36.               label: '顶部导航'
    37.             }]
    38.           }]
    39.         }, {
    40.           value: 'zujian',
    41.           label: '组件',
    42.           children: [{
    43.             value: 'basic',
    44.             label: 'Basic',
    45.             children: [{
    46.               value: 'layout',
    47.               label: 'Layout 布局'
    48.             }, {
    49.               value: 'color',
    50.               label: 'Color 色彩'
    51.             }, {
    52.               value: 'typography',
    53.               label: 'Typography 字体'
    54.             }, {
    55.               value: 'icon',
    56.               label: 'Icon 图标'
    57.             }, {
    58.               value: 'button',
    59.               label: 'Button 按钮'
    60.             }]
    61.           }, {
    62.             value: 'form',
    63.             label: 'Form',
    64.             children: [{
    65.               value: 'radio',
    66.               label: 'Radio 单选框'
    67.             }, {
    68.               value: 'checkbox',
    69.               label: 'Checkbox 多选框'
    70.             }, {
    71.               value: 'input',
    72.               label: 'Input 输入框'
    73.             }, {
    74.               value: 'input-number',
    75.               label: 'InputNumber 计数器'
    76.             }, {
    77.               value: 'select',
    78.               label: 'Select 选择器'
    79.             }, {
    80.               value: 'cascader',
    81.               label: 'Cascader 级联选择器'
    82.             }, {
    83.               value: 'switch',
    84.               label: 'Switch 开关'
    85.             }, {
    86.               value: 'slider',
    87.               label: 'Slider 滑块'
    88.             }, {
    89.               value: 'time-picker',
    90.               label: 'TimePicker 时间选择器'
    91.             }, {
    92.               value: 'date-picker',
    93.               label: 'DatePicker 日期选择器'
    94.             }, {
    95.               value: 'datetime-picker',
    96.               label: 'DateTimePicker 日期时间选择器'
    97.             }, {
    98.               value: 'upload',
    99.               label: 'Upload 上传'
    100.             }, {
    101.               value: 'rate',
    102.               label: 'Rate 评分'
    103.             }, {
    104.               value: 'form',
    105.               label: 'Form 表单'
    106.             }]
    107.           }, {
    108.             value: 'data',
    109.             label: 'Data',
    110.             children: [{
    111.               value: 'table',
    112.               label: 'Table 表格'
    113.             }, {
    114.               value: 'tag',
    115.               label: 'Tag 标签'
    116.             }, {
    117.               value: 'progress',
    118.               label: 'Progress 进度条'
    119.             }, {
    120.               value: 'tree',
    121.               label: 'Tree 树形控件'
    122.             }, {
    123.               value: 'pagination',
    124.               label: 'Pagination 分页'
    125.             }, {
    126.               value: 'badge',
    127.               label: 'Badge 标记'
    128.             }]
    129.           }, {
    130.             value: 'notice',
    131.             label: 'Notice',
    132.             children: [{
    133.               value: 'alert',
    134.               label: 'Alert 警告'
    135.             }, {
    136.               value: 'loading',
    137.               label: 'Loading 加载'
    138.             }, {
    139.               value: 'message',
    140.               label: 'Message 消息提示'
    141.             }, {
    142.               value: 'message-box',
    143.               label: 'MessageBox 弹框'
    144.             }, {
    145.               value: 'notification',
    146.               label: 'Notification 通知'
    147.             }]
    148.           }, {
    149.             value: 'navigation',
    150.             label: 'Navigation',
    151.             children: [{
    152.               value: 'menu',
    153.               label: 'NavMenu 导航菜单'
    154.             }, {
    155.               value: 'tabs',
    156.               label: 'Tabs 标签页'
    157.             }, {
    158.               value: 'breadcrumb',
    159.               label: 'Breadcrumb 面包屑'
    160.             }, {
    161.               value: 'dropdown',
    162.               label: 'Dropdown 下拉菜单'
    163.             }, {
    164.               value: 'steps',
    165.               label: 'Steps 步骤条'
    166.             }]
    167.           }, {
    168.             value: 'others',
    169.             label: 'Others',
    170.             children: [{
    171.               value: 'dialog',
    172.               label: 'Dialog 对话框'
    173.             }, {
    174.               value: 'tooltip',
    175.               label: 'Tooltip 文字提示'
    176.             }, {
    177.               value: 'popover',
    178.               label: 'Popover 弹出框'
    179.             }, {
    180.               value: 'card',
    181.               label: 'Card 卡片'
    182.             }, {
    183.               value: 'carousel',
    184.               label: 'Carousel 走马灯'
    185.             }, {
    186.               value: 'collapse',
    187.               label: 'Collapse 折叠面板'
    188.             }]
    189.           }]
    190.         }, {
    191.           value: 'ziyuan',
    192.           label: '资源',
    193.           children: [{
    194.             value: 'axure',
    195.             label: 'Axure Components'
    196.           }, {
    197.             value: 'sketch',
    198.             label: 'Sketch Templates'
    199.           }, {
    200.             value: 'jiaohu',
    201.             label: '组件交互文档'
    202.           }]
    203.         }]
    204.       };
    205.     }
    206.   };
    207. </script>

    仅显示最后一级

    可以仅在输入框中显示选中项最后一级的标签，而不是选中项所在的完整路径。

    Cascader 级联选择器 - 图3

    属性show-all-levels定义了是否显示完整的路径，将其赋值为false则仅显示最后一级

    1. <el-cascader
    2.   :options="options"
    3.   :show-all-levels="false"
    4. ></el-cascader>
    5. <script>
    6.   export default {
    7.     data() {
    8.       return {
    9.         options: [{
    10.           value: 'zhinan',
    11.           label: '指南',
    12.           children: [{
    13.             value: 'shejiyuanze',
    14.             label: '设计原则',
    15.             children: [{
    16.               value: 'yizhi',
    17.               label: '一致'
    18.             }, {
    19.               value: 'fankui',
    20.               label: '反馈'
    21.             }, {
    22.               value: 'xiaolv',
    23.               label: '效率'
    24.             }, {
    25.               value: 'kekong',
    26.               label: '可控'
    27.             }]
    28.           }, {
    29.             value: 'daohang',
    30.             label: '导航',
    31.             children: [{
    32.               value: 'cexiangdaohang',
    33.               label: '侧向导航'
    34.             }, {
    35.               value: 'dingbudaohang',
    36.               label: '顶部导航'
    37.             }]
    38.           }]
    39.         }, {
    40.           value: 'zujian',
    41.           label: '组件',
    42.           children: [{
    43.             value: 'basic',
    44.             label: 'Basic',
    45.             children: [{
    46.               value: 'layout',
    47.               label: 'Layout 布局'
    48.             }, {
    49.               value: 'color',
    50.               label: 'Color 色彩'
    51.             }, {
    52.               value: 'typography',
    53.               label: 'Typography 字体'
    54.             }, {
    55.               value: 'icon',
    56.               label: 'Icon 图标'
    57.             }, {
    58.               value: 'button',
    59.               label: 'Button 按钮'
    60.             }]
    61.           }, {
    62.             value: 'form',
    63.             label: 'Form',
    64.             children: [{
    65.               value: 'radio',
    66.               label: 'Radio 单选框'
    67.             }, {
    68.               value: 'checkbox',
    69.               label: 'Checkbox 多选框'
    70.             }, {
    71.               value: 'input',
    72.               label: 'Input 输入框'
    73.             }, {
    74.               value: 'input-number',
    75.               label: 'InputNumber 计数器'
    76.             }, {
    77.               value: 'select',
    78.               label: 'Select 选择器'
    79.             }, {
    80.               value: 'cascader',
    81.               label: 'Cascader 级联选择器'
    82.             }, {
    83.               value: 'switch',
    84.               label: 'Switch 开关'
    85.             }, {
    86.               value: 'slider',
    87.               label: 'Slider 滑块'
    88.             }, {
    89.               value: 'time-picker',
    90.               label: 'TimePicker 时间选择器'
    91.             }, {
    92.               value: 'date-picker',
    93.               label: 'DatePicker 日期选择器'
    94.             }, {
    95.               value: 'datetime-picker',
    96.               label: 'DateTimePicker 日期时间选择器'
    97.             }, {
    98.               value: 'upload',
    99.               label: 'Upload 上传'
    100.             }, {
    101.               value: 'rate',
    102.               label: 'Rate 评分'
    103.             }, {
    104.               value: 'form',
    105.               label: 'Form 表单'
    106.             }]
    107.           }, {
    108.             value: 'data',
    109.             label: 'Data',
    110.             children: [{
    111.               value: 'table',
    112.               label: 'Table 表格'
    113.             }, {
    114.               value: 'tag',
    115.               label: 'Tag 标签'
    116.             }, {
    117.               value: 'progress',
    118.               label: 'Progress 进度条'
    119.             }, {
    120.               value: 'tree',
    121.               label: 'Tree 树形控件'
    122.             }, {
    123.               value: 'pagination',
    124.               label: 'Pagination 分页'
    125.             }, {
    126.               value: 'badge',
    127.               label: 'Badge 标记'
    128.             }]
    129.           }, {
    130.             value: 'notice',
    131.             label: 'Notice',
    132.             children: [{
    133.               value: 'alert',
    134.               label: 'Alert 警告'
    135.             }, {
    136.               value: 'loading',
    137.               label: 'Loading 加载'
    138.             }, {
    139.               value: 'message',
    140.               label: 'Message 消息提示'
    141.             }, {
    142.               value: 'message-box',
    143.               label: 'MessageBox 弹框'
    144.             }, {
    145.               value: 'notification',
    146.               label: 'Notification 通知'
    147.             }]
    148.           }, {
    149.             value: 'navigation',
    150.             label: 'Navigation',
    151.             children: [{
    152.               value: 'menu',
    153.               label: 'NavMenu 导航菜单'
    154.             }, {
    155.               value: 'tabs',
    156.               label: 'Tabs 标签页'
    157.             }, {
    158.               value: 'breadcrumb',
    159.               label: 'Breadcrumb 面包屑'
    160.             }, {
    161.               value: 'dropdown',
    162.               label: 'Dropdown 下拉菜单'
    163.             }, {
    164.               value: 'steps',
    165.               label: 'Steps 步骤条'
    166.             }]
    167.           }, {
    168.             value: 'others',
    169.             label: 'Others',
    170.             children: [{
    171.               value: 'dialog',
    172.               label: 'Dialog 对话框'
    173.             }, {
    174.               value: 'tooltip',
    175.               label: 'Tooltip 文字提示'
    176.             }, {
    177.               value: 'popover',
    178.               label: 'Popover 弹出框'
    179.             }, {
    180.               value: 'card',
    181.               label: 'Card 卡片'
    182.             }, {
    183.               value: 'carousel',
    184.               label: 'Carousel 走马灯'
    185.             }, {
    186.               value: 'collapse',
    187.               label: 'Collapse 折叠面板'
    188.             }]
    189.           }]
    190.         }, {
    191.           value: 'ziyuan',
    192.           label: '资源',
    193.           children: [{
    194.             value: 'axure',
    195.             label: 'Axure Components'
    196.           }, {
    197.             value: 'sketch',
    198.             label: 'Sketch Templates'
    199.           }, {
    200.             value: 'jiaohu',
    201.             label: '组件交互文档'
    202.           }]
    203.         }]
    204.       };
    205.     }
    206.   };
    207. </script>

    默认值

    Cascader 级联选择器 - 图4

    默认值通过数组的方式指定。

    1. <el-cascader
    2.   :options="options"
    3.   v-model="selectedOptions"
    4. ></el-cascader>
    5. <script>
    6.   export default {
    7.     data() {
    8.       return {
    9.         options: [{
    10.           value: 'zhinan',
    11.           label: '指南',
    12.           children: [{
    13.             value: 'shejiyuanze',
    14.             label: '设计原则',
    15.             children: [{
    16.               value: 'yizhi',
    17.               label: '一致'
    18.             }, {
    19.               value: 'fankui',
    20.               label: '反馈'
    21.             }, {
    22.               value: 'xiaolv',
    23.               label: '效率'
    24.             }, {
    25.               value: 'kekong',
    26.               label: '可控'
    27.             }]
    28.           }, {
    29.             value: 'daohang',
    30.             label: '导航',
    31.             children: [{
    32.               value: 'cexiangdaohang',
    33.               label: '侧向导航'
    34.             }, {
    35.               value: 'dingbudaohang',
    36.               label: '顶部导航'
    37.             }]
    38.           }]
    39.         }, {
    40.           value: 'zujian',
    41.           label: '组件',
    42.           children: [{
    43.             value: 'basic',
    44.             label: 'Basic',
    45.             children: [{
    46.               value: 'layout',
    47.               label: 'Layout 布局'
    48.             }, {
    49.               value: 'color',
    50.               label: 'Color 色彩'
    51.             }, {
    52.               value: 'typography',
    53.               label: 'Typography 字体'
    54.             }, {
    55.               value: 'icon',
    56.               label: 'Icon 图标'
    57.             }, {
    58.               value: 'button',
    59.               label: 'Button 按钮'
    60.             }]
    61.           }, {
    62.             value: 'form',
    63.             label: 'Form',
    64.             children: [{
    65.               value: 'radio',
    66.               label: 'Radio 单选框'
    67.             }, {
    68.               value: 'checkbox',
    69.               label: 'Checkbox 多选框'
    70.             }, {
    71.               value: 'input',
    72.               label: 'Input 输入框'
    73.             }, {
    74.               value: 'input-number',
    75.               label: 'InputNumber 计数器'
    76.             }, {
    77.               value: 'select',
    78.               label: 'Select 选择器'
    79.             }, {
    80.               value: 'cascader',
    81.               label: 'Cascader 级联选择器'
    82.             }, {
    83.               value: 'switch',
    84.               label: 'Switch 开关'
    85.             }, {
    86.               value: 'slider',
    87.               label: 'Slider 滑块'
    88.             }, {
    89.               value: 'time-picker',
    90.               label: 'TimePicker 时间选择器'
    91.             }, {
    92.               value: 'date-picker',
    93.               label: 'DatePicker 日期选择器'
    94.             }, {
    95.               value: 'datetime-picker',
    96.               label: 'DateTimePicker 日期时间选择器'
    97.             }, {
    98.               value: 'upload',
    99.               label: 'Upload 上传'
    100.             }, {
    101.               value: 'rate',
    102.               label: 'Rate 评分'
    103.             }, {
    104.               value: 'form',
    105.               label: 'Form 表单'
    106.             }]
    107.           }, {
    108.             value: 'data',
    109.             label: 'Data',
    110.             children: [{
    111.               value: 'table',
    112.               label: 'Table 表格'
    113.             }, {
    114.               value: 'tag',
    115.               label: 'Tag 标签'
    116.             }, {
    117.               value: 'progress',
    118.               label: 'Progress 进度条'
    119.             }, {
    120.               value: 'tree',
    121.               label: 'Tree 树形控件'
    122.             }, {
    123.               value: 'pagination',
    124.               label: 'Pagination 分页'
    125.             }, {
    126.               value: 'badge',
    127.               label: 'Badge 标记'
    128.             }]
    129.           }, {
    130.             value: 'notice',
    131.             label: 'Notice',
    132.             children: [{
    133.               value: 'alert',
    134.               label: 'Alert 警告'
    135.             }, {
    136.               value: 'loading',
    137.               label: 'Loading 加载'
    138.             }, {
    139.               value: 'message',
    140.               label: 'Message 消息提示'
    141.             }, {
    142.               value: 'message-box',
    143.               label: 'MessageBox 弹框'
    144.             }, {
    145.               value: 'notification',
    146.               label: 'Notification 通知'
    147.             }]
    148.           }, {
    149.             value: 'navigation',
    150.             label: 'Navigation',
    151.             children: [{
    152.               value: 'menu',
    153.               label: 'NavMenu 导航菜单'
    154.             }, {
    155.               value: 'tabs',
    156.               label: 'Tabs 标签页'
    157.             }, {
    158.               value: 'breadcrumb',
    159.               label: 'Breadcrumb 面包屑'
    160.             }, {
    161.               value: 'dropdown',
    162.               label: 'Dropdown 下拉菜单'
    163.             }, {
    164.               value: 'steps',
    165.               label: 'Steps 步骤条'
    166.             }]
    167.           }, {
    168.             value: 'others',
    169.             label: 'Others',
    170.             children: [{
    171.               value: 'dialog',
    172.               label: 'Dialog 对话框'
    173.             }, {
    174.               value: 'tooltip',
    175.               label: 'Tooltip 文字提示'
    176.             }, {
    177.               value: 'popover',
    178.               label: 'Popover 弹出框'
    179.             }, {
    180.               value: 'card',
    181.               label: 'Card 卡片'
    182.             }, {
    183.               value: 'carousel',
    184.               label: 'Carousel 走马灯'
    185.             }, {
    186.               value: 'collapse',
    187.               label: 'Collapse 折叠面板'
    188.             }]
    189.           }]
    190.         }, {
    191.           value: 'ziyuan',
    192.           label: '资源',
    193.           children: [{
    194.             value: 'axure',
    195.             label: 'Axure Components'
    196.           }, {
    197.             value: 'sketch',
    198.             label: 'Sketch Templates'
    199.           }, {
    200.             value: 'jiaohu',
    201.             label: '组件交互文档'
    202.           }]
    203.         }],
    204.         selectedOptions: ['zujian', 'data', 'tag']
    205.       };
    206.     }
    207.   };
    208. </script>

    选择即改变

    点击或移入选项即表示选中该项，可用于选择任意一级菜单的选项。

    Cascader 级联选择器 - 图5

    若需要允许用户选择任意一级选项，则可将change-on-select赋值为true

    1. <el-cascader
    2.   :options="options"
    3.   change-on-select
    4. ></el-cascader>
    5. <script>
    6.   export default {
    7.     data() {
    8.       return {
    9.         options: [{
    10.           value: 'zhinan',
    11.           label: '指南',
    12.           children: [{
    13.             value: 'shejiyuanze',
    14.             label: '设计原则',
    15.             children: [{
    16.               value: 'yizhi',
    17.               label: '一致'
    18.             }, {
    19.               value: 'fankui',
    20.               label: '反馈'
    21.             }, {
    22.               value: 'xiaolv',
    23.               label: '效率'
    24.             }, {
    25.               value: 'kekong',
    26.               label: '可控'
    27.             }]
    28.           }, {
    29.             value: 'daohang',
    30.             label: '导航',
    31.             children: [{
    32.               value: 'cexiangdaohang',
    33.               label: '侧向导航'
    34.             }, {
    35.               value: 'dingbudaohang',
    36.               label: '顶部导航'
    37.             }]
    38.           }]
    39.         }, {
    40.           value: 'zujian',
    41.           label: '组件',
    42.           children: [{
    43.             value: 'basic',
    44.             label: 'Basic',
    45.             children: [{
    46.               value: 'layout',
    47.               label: 'Layout 布局'
    48.             }, {
    49.               value: 'color',
    50.               label: 'Color 色彩'
    51.             }, {
    52.               value: 'typography',
    53.               label: 'Typography 字体'
    54.             }, {
    55.               value: 'icon',
    56.               label: 'Icon 图标'
    57.             }, {
    58.               value: 'button',
    59.               label: 'Button 按钮'
    60.             }]
    61.           }, {
    62.             value: 'form',
    63.             label: 'Form',
    64.             children: [{
    65.               value: 'radio',
    66.               label: 'Radio 单选框'
    67.             }, {
    68.               value: 'checkbox',
    69.               label: 'Checkbox 多选框'
    70.             }, {
    71.               value: 'input',
    72.               label: 'Input 输入框'
    73.             }, {
    74.               value: 'input-number',
    75.               label: 'InputNumber 计数器'
    76.             }, {
    77.               value: 'select',
    78.               label: 'Select 选择器'
    79.             }, {
    80.               value: 'cascader',
    81.               label: 'Cascader 级联选择器'
    82.             }, {
    83.               value: 'switch',
    84.               label: 'Switch 开关'
    85.             }, {
    86.               value: 'slider',
    87.               label: 'Slider 滑块'
    88.             }, {
    89.               value: 'time-picker',
    90.               label: 'TimePicker 时间选择器'
    91.             }, {
    92.               value: 'date-picker',
    93.               label: 'DatePicker 日期选择器'
    94.             }, {
    95.               value: 'datetime-picker',
    96.               label: 'DateTimePicker 日期时间选择器'
    97.             }, {
    98.               value: 'upload',
    99.               label: 'Upload 上传'
    100.             }, {
    101.               value: 'rate',
    102.               label: 'Rate 评分'
    103.             }, {
    104.               value: 'form',
    105.               label: 'Form 表单'
    106.             }]
    107.           }, {
    108.             value: 'data',
    109.             label: 'Data',
    110.             children: [{
    111.               value: 'table',
    112.               label: 'Table 表格'
    113.             }, {
    114.               value: 'tag',
    115.               label: 'Tag 标签'
    116.             }, {
    117.               value: 'progress',
    118.               label: 'Progress 进度条'
    119.             }, {
    120.               value: 'tree',
    121.               label: 'Tree 树形控件'
    122.             }, {
    123.               value: 'pagination',
    124.               label: 'Pagination 分页'
    125.             }, {
    126.               value: 'badge',
    127.               label: 'Badge 标记'
    128.             }]
    129.           }, {
    130.             value: 'notice',
    131.             label: 'Notice',
    132.             children: [{
    133.               value: 'alert',
    134.               label: 'Alert 警告'
    135.             }, {
    136.               value: 'loading',
    137.               label: 'Loading 加载'
    138.             }, {
    139.               value: 'message',
    140.               label: 'Message 消息提示'
    141.             }, {
    142.               value: 'message-box',
    143.               label: 'MessageBox 弹框'
    144.             }, {
    145.               value: 'notification',
    146.               label: 'Notification 通知'
    147.             }]
    148.           }, {
    149.             value: 'navigation',
    150.             label: 'Navigation',
    151.             children: [{
    152.               value: 'menu',
    153.               label: 'NavMenu 导航菜单'
    154.             }, {
    155.               value: 'tabs',
    156.               label: 'Tabs 标签页'
    157.             }, {
    158.               value: 'breadcrumb',
    159.               label: 'Breadcrumb 面包屑'
    160.             }, {
    161.               value: 'dropdown',
    162.               label: 'Dropdown 下拉菜单'
    163.             }, {
    164.               value: 'steps',
    165.               label: 'Steps 步骤条'
    166.             }]
    167.           }, {
    168.             value: 'others',
    169.             label: 'Others',
    170.             children: [{
    171.               value: 'dialog',
    172.               label: 'Dialog 对话框'
    173.             }, {
    174.               value: 'tooltip',
    175.               label: 'Tooltip 文字提示'
    176.             }, {
    177.               value: 'popover',
    178.               label: 'Popover 弹出框'
    179.             }, {
    180.               value: 'card',
    181.               label: 'Card 卡片'
    182.             }, {
    183.               value: 'carousel',
    184.               label: 'Carousel 走马灯'
    185.             }, {
    186.               value: 'collapse',
    187.               label: 'Collapse 折叠面板'
    188.             }]
    189.           }]
    190.         }, {
    191.           value: 'ziyuan',
    192.           label: '资源',
    193.           children: [{
    194.             value: 'axure',
    195.             label: 'Axure Components'
    196.           }, {
    197.             value: 'sketch',
    198.             label: 'Sketch Templates'
    199.           }, {
    200.             value: 'jiaohu',
    201.             label: '组件交互文档'
    202.           }]
    203.         }]
    204.       };
    205.     }
    206.   };
    207. </script>

    动态加载次级选项

    当选中某一级时，动态加载该级下的选项。

    Cascader 级联选择器 - 图6

    本例的选项数据源在初始化时不包含城市数据。利用active-item-change事件，可以在用户点击某个省份时拉取该省份下的城市数据。此外，本例还展示了props属性的用法。

    1. <el-cascader
    2.   :options="options"
    3.   @active-item-change="handleItemChange"
    4.   :props="props"
    5. ></el-cascader>
    7. <script>
    8.   export default {
    9.     data() {
    10.       return {
    11.         options: [{
    12.           label: '江苏',
    13.           cities: []
    14.         }, {
    15.           label: '浙江',
    16.           cities: []
    17.         }],
    18.         props: {
    19.           value: 'label',
    20.           children: 'cities'
    21.         }
    22.       };
    23.     },
    25.     methods: {
    26.       handleItemChange(val) {
    27.         console.log('active item:', val);
    28.         setTimeout(_ => {
    29.           if (val.indexOf('江苏') > -1 && !this.options2[0].cities.length) {
    30.             this.options2[0].cities = [{
    31.               label: '南京'
    32.             }];
    33.           } else if (val.indexOf('浙江') > -1 && !this.options2[1].cities.length) {
    34.             this.options2[1].cities = [{
    35.               label: '杭州'
    36.             }];
    37.           }
    38.         }, 300);
    39.       }
    40.     }
    41.   };
    42. </script>

    可搜索

    可以快捷地搜索选项并选择。

    Cascader 级联选择器 - 图7

    将filterable赋值为true即可打开搜索功能。

    1. <div class="block">
    2.   <span class="demonstration">只可选择最后一级菜单的选项</span>
    3.   <el-cascader
    4.     placeholder="试试搜索：指南"
    5.     :options="options"
    6.     filterable
    7.   ></el-cascader>
    8. </div>
    9. <div class="block">
    10.   <span class="demonstration">可选择任意一级菜单的选项</span>
    11.   <el-cascader
    12.     placeholder="试试搜索：指南"
    13.     :options="options"
    14.     filterable
    15.     change-on-select
    16.   ></el-cascader>
    17. </div>
    19. <script>
    20.   export default {
    21.     data() {
    22.       return {
    23.         options: [{
    24.           value: 'zhinan',
    25.           label: '指南',
    26.           children: [{
    27.             value: 'shejiyuanze',
    28.             label: '设计原则',
    29.             children: [{
    30.               value: 'yizhi',
    31.               label: '一致'
    32.             }, {
    33.               value: 'fankui',
    34.               label: '反馈'
    35.             }, {
    36.               value: 'xiaolv',
    37.               label: '效率'
    38.             }, {
    39.               value: 'kekong',
    40.               label: '可控'
    41.             }]
    42.           }, {
    43.             value: 'daohang',
    44.             label: '导航',
    45.             children: [{
    46.               value: 'cexiangdaohang',
    47.               label: '侧向导航'
    48.             }, {
    49.               value: 'dingbudaohang',
    50.               label: '顶部导航'
    51.             }]
    52.           }]
    53.         }, {
    54.           value: 'zujian',
    55.           label: '组件',
    56.           children: [{
    57.             value: 'basic',
    58.             label: 'Basic',
    59.             children: [{
    60.               value: 'layout',
    61.               label: 'Layout 布局'
    62.             }, {
    63.               value: 'color',
    64.               label: 'Color 色彩'
    65.             }, {
    66.               value: 'typography',
    67.               label: 'Typography 字体'
    68.             }, {
    69.               value: 'icon',
    70.               label: 'Icon 图标'
    71.             }, {
    72.               value: 'button',
    73.               label: 'Button 按钮'
    74.             }]
    75.           }, {
    76.             value: 'form',
    77.             label: 'Form',
    78.             children: [{
    79.               value: 'radio',
    80.               label: 'Radio 单选框'
    81.             }, {
    82.               value: 'checkbox',
    83.               label: 'Checkbox 多选框'
    84.             }, {
    85.               value: 'input',
    86.               label: 'Input 输入框'
    87.             }, {
    88.               value: 'input-number',
    89.               label: 'InputNumber 计数器'
    90.             }, {
    91.               value: 'select',
    92.               label: 'Select 选择器'
    93.             }, {
    94.               value: 'cascader',
    95.               label: 'Cascader 级联选择器'
    96.             }, {
    97.               value: 'switch',
    98.               label: 'Switch 开关'
    99.             }, {
    100.               value: 'slider',
    101.               label: 'Slider 滑块'
    102.             }, {
    103.               value: 'time-picker',
    104.               label: 'TimePicker 时间选择器'
    105.             }, {
    106.               value: 'date-picker',
    107.               label: 'DatePicker 日期选择器'
    108.             }, {
    109.               value: 'datetime-picker',
    110.               label: 'DateTimePicker 日期时间选择器'
    111.             }, {
    112.               value: 'upload',
    113.               label: 'Upload 上传'
    114.             }, {
    115.               value: 'rate',
    116.               label: 'Rate 评分'
    117.             }, {
    118.               value: 'form',
    119.               label: 'Form 表单'
    120.             }]
    121.           }, {
    122.             value: 'data',
    123.             label: 'Data',
    124.             children: [{
    125.               value: 'table',
    126.               label: 'Table 表格'
    127.             }, {
    128.               value: 'tag',
    129.               label: 'Tag 标签'
    130.             }, {
    131.               value: 'progress',
    132.               label: 'Progress 进度条'
    133.             }, {
    134.               value: 'tree',
    135.               label: 'Tree 树形控件'
    136.             }, {
    137.               value: 'pagination',
    138.               label: 'Pagination 分页'
    139.             }, {
    140.               value: 'badge',
    141.               label: 'Badge 标记'
    142.             }]
    143.           }, {
    144.             value: 'notice',
    145.             label: 'Notice',
    146.             children: [{
    147.               value: 'alert',
    148.               label: 'Alert 警告'
    149.             }, {
    150.               value: 'loading',
    151.               label: 'Loading 加载'
    152.             }, {
    153.               value: 'message',
    154.               label: 'Message 消息提示'
    155.             }, {
    156.               value: 'message-box',
    157.               label: 'MessageBox 弹框'
    158.             }, {
    159.               value: 'notification',
    160.               label: 'Notification 通知'
    161.             }]
    162.           }, {
    163.             value: 'navigation',
    164.             label: 'Navigation',
    165.             children: [{
    166.               value: 'menu',
    167.               label: 'NavMenu 导航菜单'
    168.             }, {
    169.               value: 'tabs',
    170.               label: 'Tabs 标签页'
    171.             }, {
    172.               value: 'breadcrumb',
    173.               label: 'Breadcrumb 面包屑'
    174.             }, {
    175.               value: 'dropdown',
    176.               label: 'Dropdown 下拉菜单'
    177.             }, {
    178.               value: 'steps',
    179.               label: 'Steps 步骤条'
    180.             }]
    181.           }, {
    182.             value: 'others',
    183.             label: 'Others',
    184.             children: [{
    185.               value: 'dialog',
    186.               label: 'Dialog 对话框'
    187.             }, {
    188.               value: 'tooltip',
    189.               label: 'Tooltip 文字提示'
    190.             }, {
    191.               value: 'popover',
    192.               label: 'Popover 弹出框'
    193.             }, {
    194.               value: 'card',
    195.               label: 'Card 卡片'
    196.             }, {
    197.               value: 'carousel',
    198.               label: 'Carousel 走马灯'
    199.             }, {
    200.               value: 'collapse',
    201.               label: 'Collapse 折叠面板'
    202.             }]
    203.           }]
    204.         }, {
    205.           value: 'ziyuan',
    206.           label: '资源',
    207.           children: [{
    208.             value: 'axure',
    209.             label: 'Axure Components'
    210.           }, {
    211.             value: 'sketch',
    212.             label: 'Sketch Templates'
    213.           }, {
    214.             value: 'jiaohu',
    215.             label: '组件交互文档'
    216.           }]
    217.         }]
    218.       };
    219.     }
    220.   };
    221. </script>

    Attributes

    参数说明类型可选值默认值
    value / v-model选中项绑定值array——
    options可选项数据源，键名可通过 props 属性配置array——
    props配置选项，具体见下表object——
    separator选项分隔符string—斜杠'/'
    popper-class自定义浮层类名string——
    placeholder输入框占位文本string—请选择
    disabled是否禁用boolean—false
    clearable是否支持清空选项boolean—false
    expand-trigger次级菜单的展开方式stringclick / hoverclick
    show-all-levels输入框中是否显示选中值的完整路径boolean—true
    filterable是否可搜索选项boolean——
    debounce搜索关键词输入的去抖延迟，毫秒number—300
    change-on-select是否允许选择任意一级的选项boolean—false
    size尺寸stringmedium / small / mini—
    before-filter筛选之前的钩子，参数为输入的值，若返回 false 或者返回 Promise 且被 reject，则停止筛选function(value)——

    props

    参数说明类型可选值默认值
    value指定选项的值为选项对象的某个属性值string——
    label指定选项标签为选项对象的某个属性值string——
    children指定选项的子选项为选项对象的某个属性值string——
    disabled指定选项的禁用为选项对象的某个属性值string——

    Events

    事件名称说明回调参数
    change当绑定值变化时触发的事件当前值
    active-item-change当父级选项变化时触发的事件，仅在 change-on-select 为 false 时可用各父级选项组成的数组
    blur在 Cascader 失去焦点时触发(event: Event)
    focus在 Cascader 获得焦点时触发(event: Event)
    visible-change下拉框出现/隐藏时触发出现则为 true，隐藏则为 false