当前位置:首页 > 前端教程

elementui cascader

2026-03-06 03:20:17前端教程

ElementUI Cascader 组件使用指南

ElementUI 的 Cascader 组件是一个级联选择器,常用于选择具有层级结构的数据(如省市区、分类目录等)。以下为关键功能和使用方法:

基础用法

引入 Cascader 组件并绑定数据源即可使用:

<el-cascader :options="options" v-model="selectedOptions"></el-cascader>

数据格式要求:

elementui cascader

options: [{
  value: 'zhejiang',
  label: '浙江省',
  children: [{
    value: 'hangzhou',
    label: '杭州市',
    children: [{
      value: 'xihu',
      label: '西湖区'
    }]
  }]
}]

动态加载子节点

通过 lazy 属性和 lazyLoad 方法实现异步加载:

<el-cascader :props="props" lazy></el-cascader>
props: {
  lazy: true,
  lazyLoad(node, resolve) {
    const { level } = node;
    // 异步加载数据
    setTimeout(() => {
      const nodes = Array.from({ length: level + 1 })
        .map(item => ({ /* 节点数据 */ }));
      resolve(nodes);
    }, 500);
  }
}

可搜索功能

添加 filterable 属性启用搜索:

elementui cascader

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

自定义显示内容

通过 scoped slot 定制节点显示:

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

多选模式

设置 props.multiple 开启多选:

<el-cascader :options="options" :props="{ multiple: true }"></el-cascader>

常用属性

  • clearable:是否显示清空按钮
  • show-all-levels:是否显示完整路径
  • collapse-tags:多选时折叠标签
  • separator:选项分隔符(默认 /

注意事项

  1. 数据源的 value 字段需保持唯一性
  2. 动态加载时需确保 lazyLoad 方法正确处理异步逻辑
  3. 多选模式下数据量较大时建议启用虚拟滚动(需 ElementUI 2.15.0+)

完整文档参考 ElementUI Cascader

分享给朋友:

相关文章

修改elementui的样式

修改elementui的样式

修改 ElementUI 样式的方法 通过全局样式覆盖 在项目的全局样式文件(如 App.vue 或 main.css)中直接覆盖 ElementUI 的默认样式。需确保选择器优先级高于默认样式,可通…

selectable elementui

selectable elementui

使 ElementUI 组件可选中 ElementUI 默认情况下没有直接提供 selectable 功能的组件,但可以通过以下方法实现可选中效果。 使用 el-checkbox 实现单个选中 通过…

elementui $loading

elementui $loading

ElementUI $loading 使用方法 ElementUI 的 $loading 方法用于在页面或组件中显示加载状态,通常用于异步操作(如网络请求)期间提供视觉反馈。以下是其核心用法和配置选项…

elementui备注

elementui备注

使用 Element UI 添加备注功能 Element UI 提供了多种组件可以用来实现备注功能,具体选择取决于需求场景。以下是几种常见的实现方式: 输入框备注 使用 el-input 组件创建单…

elementui如何

elementui如何

ElementUI 基本使用 ElementUI 是一套基于 Vue.js 的桌面端组件库,提供丰富的 UI 组件和交互功能。以下是 ElementUI 的基本使用方法。 安装 ElementUI…

elementui中文

elementui中文

Element UI 中文资源 Element UI 是一款基于 Vue.js 的桌面端组件库,提供丰富的 UI 组件和友好的开发体验。以下是关于 Element UI 的中文资源和使用方法: 官方…