1. docs
sss
  • docs
    • docs
      • EleProLayout 高级布局组件使用文档
      • Markdown - ByteMdEditor
      • 下拉菜单 - EleDropdown
      • 主题功能
      • 二维码 - EleQrcode
      • 全局配置 - EleConfigProvider
      • 其他功能
      • 分段器 - EleSegmented
      • 分页组件 - ElePagination
      • 加载中 - EleLoading
      • 包裹组件 - EleApp
      • 卡片组件 - EleCard
      • 可选卡片 - EleCheckCard
      • 图标选择 - EleIconSelect
      • 富文本 - TinymceEditor
      • 导航菜单 - EleMenus
      • 工具方法与表单数据操作文档
      • 抽屉组件 - EleDrawer
      • 文字提示 - EleTooltip
      • 文本组件 - EleText
      • 标签输入 - EleEditTag
      • 标签页 - EleTabs
      • 树下拉 - EleTreeSelect
      • 步骤条 - EleSteps
      • 气泡确认框 - ElePopconfirm
      • 消息提示 - EleMessage
      • 统计图表 - VueEcharts
      • 表格下拉 - EleTableSelect
      • 表格组件 - EleDataTable
      • 警告提示 - EleAlert
      • 页面容器 - ElePage
      • 高级弹窗 - EleModal
      • 高级表格 - EleProTable
  1. docs

下拉菜单 - EleDropdown

5.17.1.快速使用
下拉菜单组件(v1.1.0新增)是对 ElDropdown 的扩展,并对原来的样式进行了美化以及属性扩展,使用示例:

运行代码 新窗口打开
如果 items 使用 ref 声明带图标(组件类型)时应该使用 shallowRef 示例:

运行代码 新窗口打开
如果需要动态控制 items 的数据可以使用 computed 声明:

运行代码 新窗口打开
5.17.2.属性列表
支持 ElDropdown 的全部属性(请查看 Element 文档),这里只列出额外增加的属性:
EleDropdown 默认基于 ElDropdown 实现,设置属性 componentType="pro" 会完全重新实现,并支持虚拟触发、多级菜单等。
例如通过 v-model 实现下拉选中,还可以通过默认插槽参数 selected 获取选中的 item 数据:


运行代码 新窗口打开
如果觉得气泡离触发元素的间距太大,或当气泡出现位置不是中间时觉得气泡箭头太靠近边缘可以通过 popperOptions 属性调整:

运行代码 新窗口打开 iconProps 属性用于统一为 items 设置图标属性(v1.1.8新增),例如统一修改图标的尺寸:

运行代码 新窗口打开
5.17.3.菜单数据
items 属性同样支持 ElDropdownItem 组件的全部属性,这里只列出额外增加的属性:
例如在下拉菜单数据中使用 danger 属性设置未危险情景色:

运行代码 新窗口打开
例如使用通过 children 属性实现多级菜单,需要先设置 componentType="pro" ,示例:

运行代码 新窗口打开
iconProps 和 iconStyle 的详细说明,在 Element 中使用图标是要包一个 ElIcon 组件的:

所以通过 iconProps 也可以设置图标的样式或 class , iconStyle 属性是考虑到你可能想直接给 SVG 加样式。 5.17.4.事件列表 支持 ElDropdown 的全部事件(请查看 Element 文档),这里只列出额外增加的事件: 5.17.5.插槽列表 例如通过 v-model 实现下拉选中,然后通过默认插槽参数 selected 获取选中的 item 数据: 运行代码 新窗口打开 5.17.6.右键触发 设置 trigger="contextmenu" 即为鼠标右键触发,如果用于 body 实现全局右键菜单,可以写在 App.vue 中,示例:

运行代码 新窗口打开
5.17.7.虚拟触发
  可通过 virtualTriggering 属性实现虚拟触发,需要先设置 componentType="pro", 虚拟触发可用于结合树组件的右键或者表格组件的右键事件使用等, 还可用于表格的操作列中的下拉菜单实现单例以提升性能,使用示例:

运行代码 新窗口打开
5.17.8.用于树右键菜单
例如用于 ElTree 组件的 item 右键菜单,使用示例:

运行代码 新窗口打开
5.17.9.用于表格右键菜单
例如用于高级表格 EleProTable 的行鼠标右键,使用示例:

运行代码 新窗口打开

修改于 2025-12-20 03:37:01
上一页
Markdown - ByteMdEditor
下一页
主题功能
Built with