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

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 table

elementui table

ElementUI Table 基本用法 ElementUI 的 Table 组件用于展示结构化数据,支持排序、筛选、分页等功能。以下是一个基础示例: <template> &…

elementui select

elementui select

ElementUI Select 组件使用指南 ElementUI 是基于 Vue.js 的组件库,其中 Select 组件用于提供下拉选择功能。以下是常见用法和配置方法。 基础用法 通过 v-mo…

elementui核心

elementui核心

Element UI 核心概念 Element UI 是基于 Vue.js 2.0 的桌面端组件库,其核心设计理念是简洁、高效、易用。以下是其核心组成部分: 组件化设计 提供丰富的 UI 组件,如…

elementui文本

elementui文本

ElementUI 文本组件 ElementUI 提供了多种文本相关的组件,用于展示和处理文本内容。以下是一些常用的文本组件及其用法: 文本展示组件 el-text 用于展示普通文本,支持自定义样式…

elementui案例

elementui案例

Element UI 案例 Element UI 是一个基于 Vue.js 的组件库,广泛用于构建企业级中后台前端界面。以下是一些常见的 Element UI 案例和使用场景: 表单设计 Eleme…

elementui import

elementui import

安装 Element UI 在项目中安装 Element UI 可以通过 npm 或 yarn 完成: npm install element-ui --save # 或 yarn add el…