Dropdown 下拉菜单

将动作或菜单折叠到下拉菜单中。

基础用法

移动到下拉菜单上，展开更多操作。

Dropdown 下拉菜单 - 图1

通过组件slot来设置下拉触发的元素以及需要通过具名slot为dropdown 来设置下拉菜单。默认情况下，下拉按钮只要hover即可，无需点击也会显示下拉菜单。

  1. <el-dropdown>
  2.   <span class="el-dropdown-link">
  3.     下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
  4.   </span>
  5.   <template #dropdown>
  6.     <el-dropdown-menu>
  7.       <el-dropdown-item>黄金糕</el-dropdown-item>
  8.       <el-dropdown-item>狮子头</el-dropdown-item>
  9.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  10.       <el-dropdown-item disabled>双皮奶</el-dropdown-item>
  11.       <el-dropdown-item divided>蚵仔煎</el-dropdown-item>
  12.     </el-dropdown-menu>
  13.   </template>
  14. </el-dropdown>
  16. <style>
  17.   .el-dropdown-link {
  18.     cursor: pointer;
  19.     color: #409EFF;
  20.   }
  21.   .el-icon-arrow-down {
  22.     font-size: 12px;
  23.   }
  24. </style>

触发对象

可使用按钮触发下拉菜单。

Dropdown 下拉菜单 - 图2

设置split-button属性来让触发下拉元素呈现为按钮组，左边是功能按钮，右边是触发下拉菜单的按钮，设置为true即可。

  1. <el-dropdown>
  2.   <el-button type="primary">
  3.     更多菜单<i class="el-icon-arrow-down el-icon--right"></i>
  4.   </el-button>
  5.   <template #dropdown>
  6.     <el-dropdown-menu>
  7.       <el-dropdown-item>黄金糕</el-dropdown-item>
  8.       <el-dropdown-item>狮子头</el-dropdown-item>
  9.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  10.       <el-dropdown-item>双皮奶</el-dropdown-item>
  11.       <el-dropdown-item>蚵仔煎</el-dropdown-item>
  12.     </el-dropdown-menu>
  13.   </template>
  14. </el-dropdown>
  15. <el-dropdown split-button type="primary" @click="handleClick">
  16.   更多菜单
  17.   <template #dropdown>
  18.     <el-dropdown-menu>
  19.       <el-dropdown-item>黄金糕</el-dropdown-item>
  20.       <el-dropdown-item>狮子头</el-dropdown-item>
  21.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  22.       <el-dropdown-item>双皮奶</el-dropdown-item>
  23.       <el-dropdown-item>蚵仔煎</el-dropdown-item>
  24.     </el-dropdown-menu>
  25.   </template>
  26. </el-dropdown>
  28. <style>
  29.   .el-dropdown {
  30.     vertical-align: top;
  31.   }
  32.   .el-dropdown + .el-dropdown {
  33.     margin-left: 15px;
  34.   }
  35.   .el-icon-arrow-down {
  36.     font-size: 12px;
  37.   }
  38. </style>
  40. <script>
  41.   export default {
  42.     methods: {
  43.       handleClick() {
  44.         alert('button click');
  45.       }
  46.     }
  47.   }
  48. </script>

触发方式

可以配置 click 激活或者 hover 激活。

Dropdown 下拉菜单 - 图3

在trigger属性设置为click即可。

  1. <el-row class="block-col-2">
  2.   <el-col :span="12">
  3.     <span class="demonstration">hover 激活</span>
  4.     <el-dropdown>
  5.       <span class="el-dropdown-link">
  6.         下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
  7.       </span>
  8.       <template #dropdown>
  9.         <el-dropdown-menu>
  10.           <el-dropdown-item icon="el-icon-plus">黄金糕</el-dropdown-item>
  11.           <el-dropdown-item icon="el-icon-circle-plus">狮子头</el-dropdown-item>
  12.           <el-dropdown-item icon="el-icon-circle-plus-outline">螺蛳粉</el-dropdown-item>
  13.           <el-dropdown-item icon="el-icon-check">双皮奶</el-dropdown-item>
  14.           <el-dropdown-item icon="el-icon-circle-check">蚵仔煎</el-dropdown-item>
  15.         </el-dropdown-menu>
  16.       </template>
  17.     </el-dropdown>
  18.   </el-col>
  19.   <el-col :span="12">
  20.     <span class="demonstration">click 激活</span>
  21.     <el-dropdown trigger="click">
  22.       <span class="el-dropdown-link">
  23.         下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
  24.       </span>
  25.       <template #dropdown>
  26.         <el-dropdown-menu>
  27.           <el-dropdown-item icon="el-icon-plus">黄金糕</el-dropdown-item>
  28.           <el-dropdown-item icon="el-icon-circle-plus">狮子头</el-dropdown-item>
  29.           <el-dropdown-item icon="el-icon-circle-plus-outline">螺蛳粉</el-dropdown-item>
  30.           <el-dropdown-item icon="el-icon-check">双皮奶</el-dropdown-item>
  31.           <el-dropdown-item icon="el-icon-circle-check">蚵仔煎</el-dropdown-item>
  32.         </el-dropdown-menu>
  33.       </template>
  34.     </el-dropdown>
  35.   </el-col>
  36. </el-row>
  38. <style>
  39.   .el-dropdown-link {
  40.     cursor: pointer;
  41.     color: #409EFF;
  42.   }
  43.   .el-icon-arrow-down {
  44.     font-size: 12px;
  45.   }
  46.   .demonstration {
  47.     display: block;
  48.     color: #8492a6;
  49.     font-size: 14px;
  50.     margin-bottom: 20px;
  51.   }
  52. </style>

菜单隐藏方式

可以hide-on-click属性来配置。

Dropdown 下拉菜单 - 图4

下拉菜单默认在点击菜单项后会被隐藏，将hide-on-click属性默认为false可以关闭此功能。

  1. <el-dropdown :hide-on-click="false">
  2.   <span class="el-dropdown-link">
  3.     下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
  4.   </span>
  5.   <template #dropdown>
  6.     <el-dropdown-menu>
  7.       <el-dropdown-item>黄金糕</el-dropdown-item>
  8.       <el-dropdown-item>狮子头</el-dropdown-item>
  9.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  10.       <el-dropdown-item disabled>双皮奶</el-dropdown-item>
  11.       <el-dropdown-item divided>蚵仔煎</el-dropdown-item>
  12.     </el-dropdown-menu>
  13.   </template>
  14. </el-dropdown>
  16. <style>
  17.   .el-dropdown-link {
  18.     cursor: pointer;
  19.     color: #409EFF;
  20.   }
  21.   .el-icon-arrow-down {
  22.     font-size: 12px;
  23.   }
  24. </style>

指令事件

点击菜单项后会触发事件，用户可以通过相应的菜单项 key 进行不同的操作

Dropdown 下拉菜单 - 图5

  1. <el-dropdown @command="handleCommand">
  2.   <span class="el-dropdown-link">
  3.     下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
  4.   </span>
  5.   <template #dropdown>
  6.     <el-dropdown-menu>
  7.       <el-dropdown-item command="a">黄金糕</el-dropdown-item>
  8.       <el-dropdown-item command="b">狮子头</el-dropdown-item>
  9.       <el-dropdown-item command="c">螺蛳粉</el-dropdown-item>
  10.       <el-dropdown-item command="d" disabled>双皮奶</el-dropdown-item>
  11.       <el-dropdown-item command="e" divided>蚵仔煎</el-dropdown-item>
  12.     </el-dropdown-menu>
  13.   </template>
  14. </el-dropdown>
  16. <style>
  17.   .el-dropdown-link {
  18.     cursor: pointer;
  19.     color: #409EFF;
  20.   }
  21.   .el-icon-arrow-down {
  22.     font-size: 12px;
  23.   }
  24. </style>
  26. <script>
  27.   export default {
  28.     methods: {
  29.       handleCommand(command) {
  30.         this.$message('click on item ' + command);
  31.       }
  32.     }
  33.   }
  34. </script>

不同尺寸

Dropdown 组件提供除了默认值以外的三种尺寸，可以在不同场景下选择合适的尺寸。

Dropdown 下拉菜单 - 图6

额外的尺寸：medium、small、mini，通过设置size属性来配置它们。

  1. <el-dropdown split-button type="primary">
  2.   默认尺寸
  3.   <template #dropdown>
  4.     <el-dropdown-menu>
  5.       <el-dropdown-item>黄金糕</el-dropdown-item>
  6.       <el-dropdown-item>狮子头</el-dropdown-item>
  7.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  8.       <el-dropdown-item>双皮奶</el-dropdown-item>
  9.       <el-dropdown-item>蚵仔煎</el-dropdown-item>
  10.     </el-dropdown-menu>
  11.   </template>
  12. </el-dropdown>
  14. <el-dropdown size="medium" split-button type="primary">
  15.   中等尺寸
  16.   <template #dropdown>
  17.     <el-dropdown-menu>
  18.       <el-dropdown-item>黄金糕</el-dropdown-item>
  19.       <el-dropdown-item>狮子头</el-dropdown-item>
  20.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  21.       <el-dropdown-item>双皮奶</el-dropdown-item>
  22.       <el-dropdown-item>蚵仔煎</el-dropdown-item>
  23.     </el-dropdown-menu>
  24.   </template>
  25. </el-dropdown>
  27. <el-dropdown size="small" split-button type="primary">
  28.   小型尺寸
  29.   <template #dropdown>
  30.     <el-dropdown-menu>
  31.       <el-dropdown-item>黄金糕</el-dropdown-item>
  32.       <el-dropdown-item>狮子头</el-dropdown-item>
  33.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  34.       <el-dropdown-item>双皮奶</el-dropdown-item>
  35.       <el-dropdown-item>蚵仔煎</el-dropdown-item>
  36.     </el-dropdown-menu>
  37.   </template>
  38. </el-dropdown>
  40. <el-dropdown size="mini" split-button type="primary">
  41.   超小尺寸
  42.   <template #dropdown>
  43.     <el-dropdown-menu>
  44.       <el-dropdown-item>黄金糕</el-dropdown-item>
  45.       <el-dropdown-item>狮子头</el-dropdown-item>
  46.       <el-dropdown-item>螺蛳粉</el-dropdown-item>
  47.       <el-dropdown-item>双皮奶</el-dropdown-item>
  48.       <el-dropdown-item>蚵仔煎</el-dropdown-item>
  49.     </el-dropdown-menu>
  50.   </template>
  51. </el-dropdown>

Dropdown Attributes

参数说明类型可选值默认值
type菜单按钮类型，同 Button 组件(只在split-button为 true 的情况下有效)string——
size菜单尺寸，在split-button为 true 的情况下也对触发按钮生效stringmedium / small / mini—
split-button下拉触发元素呈现为按钮组boolean—false
placement菜单弹出位置stringtop/top-start/top-end/bottom/bottom-start/bottom-endbottom-end
trigger触发下拉的行为stringhover, clickhover
hide-on-click是否在点击菜单项后隐藏菜单boolean—true
show-timeout展开下拉菜单的延时（仅在 trigger 为 hover 时有效）number—250
hide-timeout收起下拉菜单的延时（仅在 trigger 为 hover 时有效）number—150
tabindexDropdown 组件的 tabindexnumber—0

Dropdown Slots

Name说明
—触发下拉列表显示的元素。 注意： 必须是一个元素或者或者组件
dropdown下拉列表，通常是 <el-dropdown-menu> 组件

Dropdown Events

事件名称说明回调参数
clicksplit-button 为 true 时，点击左侧按钮的回调—
command点击菜单项触发的事件回调dropdown-item 的指令
visible-change下拉框出现/隐藏时触发出现则为 true，隐藏则为 false

Dropdown Menu Item Attributes

参数说明类型可选值默认值
command指令string/number/object——
disabled禁用boolean—false
divided显示分割线boolean—false
icon图标类名string——