Dropdown 下拉菜单

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

基础用法

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

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

位置

支持 6 个位置。

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

触发对象

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

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

触发方式

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

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

Virtual triggering 2.11.3

Sometimes we want to render the dropdown on some other trigger element, we can separate the trigger and the content.

Right click
属性名说明类型Default
type菜单按钮类型,同 Button 组件一样,仅在 split-button 为 true 的情况下有效。enum''
size菜单尺寸,在 split-button 为 true 的情况下也对触发按钮生效。enum''
button-props按钮组件的 props,参考 按钮属性object
max-height菜单最大高度string / number''
split-button下拉触发元素呈现为按钮组booleanfalse
disabled是否禁用booleanfalse
placement菜单弹出位置enumbottom
trigger触发下拉的行为enumhover
trigger-keys 2.9.1指定键盘上哪些按键可以触发操作array['Enter', 'Space', 'ArrowDown', 'NumpadEnter']
virtual-triggering 2.11.3indicates whether virtual triggering is enabledboolean
virtual-ref 2.11.3indicates the reference element to which the dropdown is attachedHTMLElement
hide-on-click是否在点击菜单项后隐藏菜单booleantrue
show-arrow 2.11.3tooltip 的内容是否有箭头booleantrue
show-timeout展开下拉菜单的延时,仅在 trigger 为 hover 时有效number150
hide-timeout收起下拉菜单的延时(仅在 trigger 为 hover 时有效)number150
role下拉菜单的 ARIA 属性。 根据具体场景,您可能想要将此更改为“navigation”enummenu
tabindexDropdown 组件的 tabindexnumber / string0
popper-class自定义浮层类名string''
popper-optionspopper.js 参数object{modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]}
teleported 2.2.20是否将下拉列表插入至 body 元素booleantrue
persistent 2.9.5当下拉菜单处于非活动状态且 persistentfalse 时,下拉菜单将被销毁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内容

源代码

组件样式文档

贡献者