codecamp

ElementPlus Cascader 级联选择器

Cascader 级联选择器

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

基础用法

有两种触发子菜单的方式


只需为 Cascader 的options属性指定选项数组即可渲染出一个级联选择器。通过props.expandTrigger可以定义展开子级菜单的触发方式。

<template>
  <div class="block">
  <span class="demonstration">默认 click 触发子菜单</span>
  <el-cascader
    v-model="value"
    :options="options"
    @change="handleChange"
  ></el-cascader>
</div>
<div class="block">
  <span class="demonstration">hover 触发子菜单</span>
  <el-cascader
    v-model="value"
    :options="options"
    :props="props"
    @change="handleChange"
  ></el-cascader>
</div>
</template>

<script>
  export default {
    data() {
      return {
        value: [],
        props: { expandTrigger: 'hover' },
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
    methods: {
      handleChange(value) {
        console.log(value)
      },
    },
  }
</script>

禁用选项

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


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

<template>
  <el-cascader :options="options"></el-cascader>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            disabled: true,
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

可清空

通过 clearable 设置输入框可清空


<template>
  <el-cascader :options="options" clearable></el-cascader>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

仅显示最后一级

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


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

<template>
  <el-cascader :options="options" :show-all-levels="false"></el-cascader>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

多选

可通过 props.multiple = true 来开启多选模式


在开启多选模式后,默认情况下会展示所有已选中的选项的 Tag,你可以使用collapse-tags来折叠 Tag

<template>
  <div class="block">
  <span class="demonstration">默认显示所有Tag</span>
  <el-cascader :options="options" :props="props" clearable></el-cascader>
</div>
<div class="block">
  <span class="demonstration">折叠展示Tag</span>
  <el-cascader
    :options="options"
    :props="props"
    collapse-tags
    clearable
  ></el-cascader>
</div>
</template>

<script>
  export default {
    data() {
      return {
        props: { multiple: true },
        options: [
          {
            value: 1,
            label: '东南',
            children: [
              {
                value: 2,
                label: '上海',
                children: [
                  { value: 3, label: '普陀' },
                  { value: 4, label: '黄埔' },
                  { value: 5, label: '徐汇' },
                ],
              },
              {
                value: 7,
                label: '江苏',
                children: [
                  { value: 8, label: '南京' },
                  { value: 9, label: '苏州' },
                  { value: 10, label: '无锡' },
                ],
              },
              {
                value: 12,
                label: '浙江',
                children: [
                  { value: 13, label: '杭州' },
                  { value: 14, label: '宁波' },
                  { value: 15, label: '嘉兴' },
                ],
              },
            ],
          },
          {
            value: 17,
            label: '西北',
            children: [
              {
                value: 18,
                label: '陕西',
                children: [
                  { value: 19, label: '西安' },
                  { value: 20, label: '延安' },
                ],
              },
              {
                value: 21,
                label: '新疆维吾尔族自治区',
                children: [
                  { value: 22, label: '乌鲁木齐' },
                  { value: 23, label: '克拉玛依' },
                ],
              },
            ],
          },
        ],
      }
    },
  }
</script>

选择任意一级选项

在单选模式下,你只能选择叶子节点;而在多选模式下,勾选父节点真正选中的都是叶子节点。启用该功能后,可让父子节点取消关联,选择任意一级选项。


可通过 props.checkStrictly = true 来设置父子节点取消选中关联,从而达到选择任意一级选项的目的。

<template>
  <div class="block">
  <span class="demonstration">单选选择任意一级选项</span>
  <el-cascader
    :options="options"
    :props="{ checkStrictly: true }"
    clearable
  ></el-cascader>
</div>
<div class="block">
  <span class="demonstration">多选选择任意一级选项</span>
  <el-cascader
    :options="options"
    :props="{ multiple: true, checkStrictly: true }"
    clearable
  ></el-cascader>
</div>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

动态加载

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


通过lazy开启动态加载,并通过lazyload来设置加载数据源的方法。lazyload方法有两个参数,第一个参数node为当前点击的节点,第二个resolve为数据加载完成的回调(必须调用)。为了更准确的显示节点的状态,还可以对节点数据添加是否为叶子节点的标志位 (默认字段为leaf,可通过props.leaf修改),否则会简单的以有无子节点来判断是否为叶子节点。

<template>
  <el-cascader :props="props"></el-cascader>
</template>

<script>
  let id = 0

  export default {
    data() {
      return {
        props: {
          lazy: true,
          lazyLoad(node, resolve) {
            const { level } = node
            setTimeout(() => {
              const nodes = Array.from({ length: level + 1 }).map((item) => ({
                value: ++id,
                label: `选项${id}`,
                leaf: level >= 2,
              }))
              // 通过调用resolve将子节点数据返回,通知组件数据加载完成
              resolve(nodes)
            }, 1000)
          },
        },
      }
    },
  }
</script>

可搜索

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


将filterable赋值为true即可打开搜索功能,默认会匹配节点的label或所有父节点的label(由show-all-levels决定)中包含输入值的选项。你也可以用filter-method自定义搜索逻辑,接受一个函数,第一个参数是节点node,第二个参数是搜索关键词keyword,通过返回布尔值表示是否命中。

<template>
  <div class="block">
  <span class="demonstration">单选可搜索</span>
  <el-cascader
    placeholder="试试搜索:指南"
    :options="options"
    filterable
  ></el-cascader>
</div>
<div class="block">
  <span class="demonstration">多选可搜索</span>
  <el-cascader
    placeholder="试试搜索:指南"
    :options="options"
    :props="{ multiple: true }"
    filterable
  ></el-cascader>
</div>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

自定义节点内容

可以自定义备选项的节点内容


可以通过scoped slot对级联选择器的备选项的节点内容进行自定义,scoped slot 会传入两个字段 node 和 data,分别表示当前节点的 Node 对象和数据。

<template>
  <el-cascader :options="options">
  <template #default="{ node, data }">
    <span>{{ data.label }}</span>
    <span v-if="!node.isLeaf"> ({{ data.children.length }}) </span>
  </template>
</el-cascader>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

级联面板

级联面板是级联选择器的核心组件,与级联选择器一样,有单选、多选、动态加载等多种功能。


和级联选择器一样,通过options来指定选项,也可通过props来设置多选、动态加载等功能,具体详情见下方 API 表格。

<template>
  <el-cascader-panel :options="options"></el-cascader-panel>
</template>

<script>
  export default {
    data() {
      return {
        options: [
          {
            value: 'zhinan',
            label: '指南',
            children: [
              {
                value: 'shejiyuanze',
                label: '设计原则',
                children: [
                  {
                    value: 'yizhi',
                    label: '一致',
                  },
                  {
                    value: 'fankui',
                    label: '反馈',
                  },
                  {
                    value: 'xiaolv',
                    label: '效率',
                  },
                  {
                    value: 'kekong',
                    label: '可控',
                  },
                ],
              },
              {
                value: 'daohang',
                label: '导航',
                children: [
                  {
                    value: 'cexiangdaohang',
                    label: '侧向导航',
                  },
                  {
                    value: 'dingbudaohang',
                    label: '顶部导航',
                  },
                ],
              },
            ],
          },
          {
            value: 'zujian',
            label: '组件',
            children: [
              {
                value: 'basic',
                label: 'Basic',
                children: [
                  {
                    value: 'layout',
                    label: 'Layout 布局',
                  },
                  {
                    value: 'color',
                    label: 'Color 色彩',
                  },
                  {
                    value: 'typography',
                    label: 'Typography 字体',
                  },
                  {
                    value: 'icon',
                    label: 'Icon 图标',
                  },
                  {
                    value: 'button',
                    label: 'Button 按钮',
                  },
                ],
              },
              {
                value: 'form',
                label: 'Form',
                children: [
                  {
                    value: 'radio',
                    label: 'Radio 单选框',
                  },
                  {
                    value: 'checkbox',
                    label: 'Checkbox 多选框',
                  },
                  {
                    value: 'input',
                    label: 'Input 输入框',
                  },
                  {
                    value: 'input-number',
                    label: 'InputNumber 计数器',
                  },
                  {
                    value: 'select',
                    label: 'Select 选择器',
                  },
                  {
                    value: 'cascader',
                    label: 'Cascader 级联选择器',
                  },
                  {
                    value: 'switch',
                    label: 'Switch 开关',
                  },
                  {
                    value: 'slider',
                    label: 'Slider 滑块',
                  },
                  {
                    value: 'time-picker',
                    label: 'TimePicker 时间选择器',
                  },
                  {
                    value: 'date-picker',
                    label: 'DatePicker 日期选择器',
                  },
                  {
                    value: 'datetime-picker',
                    label: 'DateTimePicker 日期时间选择器',
                  },
                  {
                    value: 'upload',
                    label: 'Upload 上传',
                  },
                  {
                    value: 'rate',
                    label: 'Rate 评分',
                  },
                  {
                    value: 'form',
                    label: 'Form 表单',
                  },
                ],
              },
              {
                value: 'data',
                label: 'Data',
                children: [
                  {
                    value: 'table',
                    label: 'Table 表格',
                  },
                  {
                    value: 'tag',
                    label: 'Tag 标签',
                  },
                  {
                    value: 'progress',
                    label: 'Progress 进度条',
                  },
                  {
                    value: 'tree',
                    label: 'Tree 树形控件',
                  },
                  {
                    value: 'pagination',
                    label: 'Pagination 分页',
                  },
                  {
                    value: 'badge',
                    label: 'Badge 标记',
                  },
                ],
              },
              {
                value: 'notice',
                label: 'Notice',
                children: [
                  {
                    value: 'alert',
                    label: 'Alert 警告',
                  },
                  {
                    value: 'loading',
                    label: 'Loading 加载',
                  },
                  {
                    value: 'message',
                    label: 'Message 消息提示',
                  },
                  {
                    value: 'message-box',
                    label: 'MessageBox 弹框',
                  },
                  {
                    value: 'notification',
                    label: 'Notification 通知',
                  },
                ],
              },
              {
                value: 'navigation',
                label: 'Navigation',
                children: [
                  {
                    value: 'menu',
                    label: 'NavMenu 导航菜单',
                  },
                  {
                    value: 'tabs',
                    label: 'Tabs 标签页',
                  },
                  {
                    value: 'breadcrumb',
                    label: 'Breadcrumb 面包屑',
                  },
                  {
                    value: 'dropdown',
                    label: 'Dropdown 下拉菜单',
                  },
                  {
                    value: 'steps',
                    label: 'Steps 步骤条',
                  },
                ],
              },
              {
                value: 'others',
                label: 'Others',
                children: [
                  {
                    value: 'dialog',
                    label: 'Dialog 对话框',
                  },
                  {
                    value: 'tooltip',
                    label: 'Tooltip 文字提示',
                  },
                  {
                    value: 'popover',
                    label: 'Popover 弹出框',
                  },
                  {
                    value: 'card',
                    label: 'Card 卡片',
                  },
                  {
                    value: 'carousel',
                    label: 'Carousel 走马灯',
                  },
                  {
                    value: 'collapse',
                    label: 'Collapse 折叠面板',
                  },
                ],
              },
            ],
          },
          {
            value: 'ziyuan',
            label: '资源',
            children: [
              {
                value: 'axure',
                label: 'Axure Components',
              },
              {
                value: 'sketch',
                label: 'Sketch Templates',
              },
              {
                value: 'jiaohu',
                label: '组件交互文档',
              },
            ],
          },
        ],
      }
    },
  }
</script>

Cascader Attributes

参数说明类型可选值默认值
model-value / v-model选中项绑定值-
options可选项数据源,键名可通过 Props 属性配置array
props配置选项,具体见下表object
size尺寸stringmedium / small / mini
placeholder输入框占位文本string请选择
disabled是否禁用booleanfalse
clearable是否支持清空选项booleanfalse
show-all-levels输入框中是否显示选中值的完整路径booleantrue
collapse-tags多选模式下是否折叠 Tagboolean-false
separator选项分隔符string斜杠' / '
filterable是否可搜索选项boolean
filter-method自定义搜索逻辑,第一个参数是节点node,第二个参数是搜索关键词keyword,通过返回布尔值表示是否命中function(node, keyword)--
debounce搜索关键词输入的去抖延迟,毫秒number300
before-filter筛选之前的钩子,参数为输入的值,若返回 false 或者返回 Promise 且被 reject,则停止筛选function(value)
popper-class自定义浮层类名string
popper-append-to-body是否将弹出框插入至 body 元素。在弹出框的定位出现问题时,可将该属性设置为 falseboolean-true

Cascader Events

事件名称说明回调参数
change当选中节点变化时触发选中节点的值
expand-change当展开节点发生变化时触发各父级选项值组成的数组
blur当失去焦点时触发(event: Event)
focus当获得焦点时触发(event: Event)
visible-change下拉框出现/隐藏时触发出现则为 true,隐藏则为 false
remove-tag在多选模式下,移除 Tag 时触发移除的 Tag 对应的节点的值

Cascader Methods

方法名说明参数
getCheckedNodes获取选中的节点(leafOnly) 是否只是叶子节点,默认值为 false

Cascader Slots

名称说明
-自定义备选项的节点内容,参数为 { node, data },分别为当前节点的 Node 对象和数据
empty无匹配选项时的内容

CascaderPanel Attributes

参数说明类型可选值默认值
model-value / v-model选中项绑定值-
options可选项数据源,键名可通过 Props 属性配置array
props配置选项,具体见下表object

 CascaderPanel Events

事件名称说明回调参数
change当选中节点变化时触发选中节点的值
expand-change当展开节点发生变化时触发各父级选项值组成的数组

CascaderPanel Methods

方法名说明参数
getCheckedNodes获取选中的节点数组(leafOnly) 是否只是叶子节点,默认值为 false
clearCheckedNodes清空选中的节点-

CascaderPanel Slots

名称说明
-自定义备选项的节点内容,参数为 { node, data },分别为当前节点的 Node 对象和数据

 Props

参数说明类型可选值默认值
expandTrigger次级菜单的展开方式stringclick / hover'click'
multiple是否多选boolean-false
checkStrictly是否严格的遵守父子节点不互相关联boolean-false
emitPath在选中节点改变时,是否返回由该节点所在的各级菜单的值所组成的数组,若设置 false,则只返回该节点的值boolean-true
lazy是否动态加载子节点,需与 lazyLoad 方法结合使用boolean-false
lazyLoad加载动态数据的方法,仅在 lazy 为 true 时有效function(node, resolve),node为当前点击的节点,resolve为数据加载完成的回调(必须调用)--
value指定选项的值为选项对象的某个属性值string'value'
label指定选项标签为选项对象的某个属性值string'label'
children指定选项的子选项为选项对象的某个属性值string'children'
disabled指定选项的禁用为选项对象的某个属性值string'disabled'
leaf指定选项的叶子节点的标志位为选项对象的某个属性值string'leaf'


ElementPlus Select V2 虚拟列表选择器
ElementPlus Switch 开关
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

ElementPlus 配置

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }