Dropdown 下拉菜单

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

基础用法

悬停在下拉菜单上以展开更多操作。

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

位置

支持 6 个位置。

设置 placement 属性,使下拉菜单出现在不同位置。

触发对象

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

设置 split-button 属性来让触发下拉元素呈现为按钮组,左边是功能按钮,右边是触发下拉菜单的按钮,设置为 true 即可。 如果你想要在第三和第四个选项之间添加一个分隔符,你只需要为第四个选项添加一个 divider 的 CSS class。

触发方式

可以配置点击激活或者悬停激活。

trigger 属性设置为 click 即可, 默认为 hover

hover to trigger
click to trigger
right click to trigger

菜单隐藏方式

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

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

指令事件

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

下拉方法

您可以手动使用 手动打开手动关闭下拉菜单以打开或关闭

open(close) the Dropdown list2 will close(open) the Dropdown List1.

尺寸

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

使用 size 属性配置尺寸,可选的尺寸大小有: large, defaultsmall

属性名说明类型Default
type菜单按钮类型,同 Button 组件一样,仅在 split-button 为 true 的情况下有效。enum''
size菜单尺寸,在 split-button 为 true 的情况下也对触发按钮生效。enum''
max-height菜单最大高度string / number''
split-button下拉触发元素呈现为按钮组booleanfalse
disabled是否禁用booleanfalse
placement菜单弹出位置enumbottom
trigger触发下拉的行为enumhover
triggerKeys 2.9.1指定键盘上哪些按键可以触发操作array['Enter', 'Space', 'ArrowDown', 'NumpadEnter']
hide-on-click是否在点击菜单项后隐藏菜单booleantrue
show-timeout展开下拉菜单的延时,仅在 trigger 为 hover 时有效number150
hide-timeout收起下拉菜单的延时(仅在 trigger 为 hover 时有效)number150
role下拉菜单的 ARIA 属性。 根据具体场景,您可能想要将此更改为“navigation”stringmenu
tabindexDropdown 组件的 tabindexnumber / string0
popper-class自定义浮层类名string''
popper-optionspopper.js 参数object{modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]}
teleported 2.2.20是否将下拉列表插入至 body 元素booleantrue
插槽名说明子标签
default下拉菜单的内容。 注意:必须是有效的 html DOM 元素(例如 <span>、<button> 等)或 el-component,以附加监听触发器
dropdown下拉列表,通常是 <el-dropdown-menu> 组件Dropdown-Menu
事件名说明类型
clicksplit-button 为 true 时,点击左侧按钮的回调Function
command当下拉项被点击时触发,参数是从下拉菜单中发送的命令Function
visible-change当下拉菜单出现/消失时触发器, 当它出现时, 参数将是 true, 否则将是 falseFunction
方法名说明Type
handleOpen打开下拉菜单Function
handleClose关闭下拉菜单Function
插槽名说明子标签
default下拉菜单的内容Dropdown-Item
属性名说明Type默认值
command派发到command回调函数的指令参数string / number / object
disabled是否禁用booleanfalse
divided是否显示分隔符booleanfalse
icon自定义图标string / Component
插槽名说明
default自定义Dropdown-Item内容

源代码

组件样式文档

贡献者