• Dropdown 下拉菜单
    • 基础用法
    • 触发对象
    • 触发方式
    • 菜单隐藏方式
    • 指令事件
    • 不同尺寸
    • Dropdown Attributes
    • Dropdown Slots
    • Dropdown Events
    • Dropdown Menu Item Attributes

    Dropdown 下拉菜单

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

    基础用法

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

    Dropdown 下拉菜单 - 图1

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

    1. <el-dropdown>
    2. <span class="el-dropdown-link">
    3. 下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
    4. </span>
    5. <el-dropdown-menu slot="dropdown">
    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 disabled>双皮奶</el-dropdown-item>
    10. <el-dropdown-item divided>蚵仔煎</el-dropdown-item>
    11. </el-dropdown-menu>
    12. </el-dropdown>
    13. <style>
    14. .el-dropdown-link {
    15. cursor: pointer;
    16. color: #409EFF;
    17. }
    18. .el-icon-arrow-down {
    19. font-size: 12px;
    20. }
    21. </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. <el-dropdown-menu slot="dropdown">
    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-item>蚵仔煎</el-dropdown-item>
    11. </el-dropdown-menu>
    12. </el-dropdown>
    13. <el-dropdown split-button type="primary" @click="handleClick">
    14. 更多菜单
    15. <el-dropdown-menu slot="dropdown">
    16. <el-dropdown-item>黄金糕</el-dropdown-item>
    17. <el-dropdown-item>狮子头</el-dropdown-item>
    18. <el-dropdown-item>螺蛳粉</el-dropdown-item>
    19. <el-dropdown-item>双皮奶</el-dropdown-item>
    20. <el-dropdown-item>蚵仔煎</el-dropdown-item>
    21. </el-dropdown-menu>
    22. </el-dropdown>
    23. <style>
    24. .el-dropdown {
    25. vertical-align: top;
    26. }
    27. .el-dropdown + .el-dropdown {
    28. margin-left: 15px;
    29. }
    30. .el-icon-arrow-down {
    31. font-size: 12px;
    32. }
    33. </style>
    34. <script>
    35. export default {
    36. methods: {
    37. handleClick() {
    38. alert('button click');
    39. }
    40. }
    41. }
    42. </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. <el-dropdown-menu slot="dropdown">
    9. <el-dropdown-item icon="el-icon-plus">黄金糕</el-dropdown-item>
    10. <el-dropdown-item icon="el-icon-circle-plus">狮子头</el-dropdown-item>
    11. <el-dropdown-item icon="el-icon-circle-plus-outline">螺蛳粉</el-dropdown-item>
    12. <el-dropdown-item icon="el-icon-check">双皮奶</el-dropdown-item>
    13. <el-dropdown-item icon="el-icon-circle-check-outline">蚵仔煎</el-dropdown-item>
    14. </el-dropdown-menu>
    15. </el-dropdown>
    16. </el-col>
    17. <el-col :span="12">
    18. <span class="demonstration">click 激活</span>
    19. <el-dropdown trigger="click">
    20. <span class="el-dropdown-link">
    21. 下拉菜单<i class="el-icon-arrow-down el-icon--right"></i>
    22. </span>
    23. <el-dropdown-menu slot="dropdown">
    24. <el-dropdown-item icon="el-icon-plus">黄金糕</el-dropdown-item>
    25. <el-dropdown-item icon="el-icon-circle-plus">狮子头</el-dropdown-item>
    26. <el-dropdown-item icon="el-icon-circle-plus-outline">螺蛳粉</el-dropdown-item>
    27. <el-dropdown-item icon="el-icon-check">双皮奶</el-dropdown-item>
    28. <el-dropdown-item icon="el-icon-circle-check-outline">蚵仔煎</el-dropdown-item>
    29. </el-dropdown-menu>
    30. </el-dropdown>
    31. </el-col>
    32. </el-row>
    33. <style>
    34. .el-dropdown-link {
    35. cursor: pointer;
    36. color: #409EFF;
    37. }
    38. .el-icon-arrow-down {
    39. font-size: 12px;
    40. }
    41. .demonstration {
    42. display: block;
    43. color: #8492a6;
    44. font-size: 14px;
    45. margin-bottom: 20px;
    46. }
    47. </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. <el-dropdown-menu slot="dropdown">
    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 disabled>双皮奶</el-dropdown-item>
    10. <el-dropdown-item divided>蚵仔煎</el-dropdown-item>
    11. </el-dropdown-menu>
    12. </el-dropdown>
    13. <style>
    14. .el-dropdown-link {
    15. cursor: pointer;
    16. color: #409EFF;
    17. }
    18. .el-icon-arrow-down {
    19. font-size: 12px;
    20. }
    21. </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. <el-dropdown-menu slot="dropdown">
    6. <el-dropdown-item command="a">黄金糕</el-dropdown-item>
    7. <el-dropdown-item command="b">狮子头</el-dropdown-item>
    8. <el-dropdown-item command="c">螺蛳粉</el-dropdown-item>
    9. <el-dropdown-item command="d" disabled>双皮奶</el-dropdown-item>
    10. <el-dropdown-item command="e" divided>蚵仔煎</el-dropdown-item>
    11. </el-dropdown-menu>
    12. </el-dropdown>
    13. <style>
    14. .el-dropdown-link {
    15. cursor: pointer;
    16. color: #409EFF;
    17. }
    18. .el-icon-arrow-down {
    19. font-size: 12px;
    20. }
    21. </style>
    22. <script>
    23. export default {
    24. methods: {
    25. handleCommand(command) {
    26. this.$message('click on item ' + command);
    27. }
    28. }
    29. }
    30. </script>

    不同尺寸

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

    Dropdown 下拉菜单 - 图6

    额外的尺寸:mediumsmallmini,通过设置size属性来配置它们。

    1. <el-dropdown split-button type="primary">
    2. 默认尺寸
    3. <el-dropdown-menu slot="dropdown">
    4. <el-dropdown-item>黄金糕</el-dropdown-item>
    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-menu>
    10. </el-dropdown>
    11. <el-dropdown size="medium" split-button type="primary">
    12. 中等尺寸
    13. <el-dropdown-menu slot="dropdown">
    14. <el-dropdown-item>黄金糕</el-dropdown-item>
    15. <el-dropdown-item>狮子头</el-dropdown-item>
    16. <el-dropdown-item>螺蛳粉</el-dropdown-item>
    17. <el-dropdown-item>双皮奶</el-dropdown-item>
    18. <el-dropdown-item>蚵仔煎</el-dropdown-item>
    19. </el-dropdown-menu>
    20. </el-dropdown>
    21. <el-dropdown size="small" split-button type="primary">
    22. 小型尺寸
    23. <el-dropdown-menu slot="dropdown">
    24. <el-dropdown-item>黄金糕</el-dropdown-item>
    25. <el-dropdown-item>狮子头</el-dropdown-item>
    26. <el-dropdown-item>螺蛳粉</el-dropdown-item>
    27. <el-dropdown-item>双皮奶</el-dropdown-item>
    28. <el-dropdown-item>蚵仔煎</el-dropdown-item>
    29. </el-dropdown-menu>
    30. </el-dropdown>
    31. <el-dropdown size="mini" split-button type="primary">
    32. 超小尺寸
    33. <el-dropdown-menu slot="dropdown">
    34. <el-dropdown-item>黄金糕</el-dropdown-item>
    35. <el-dropdown-item>狮子头</el-dropdown-item>
    36. <el-dropdown-item>螺蛳粉</el-dropdown-item>
    37. <el-dropdown-item>双皮奶</el-dropdown-item>
    38. <el-dropdown-item>蚵仔煎</el-dropdown-item>
    39. </el-dropdown-menu>
    40. </el-dropdown>

    Dropdown Attributes

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

    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禁用booleanfalse
    divided显示分割线booleanfalse
    icon图标类名string