Dropdown 下拉菜单

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

基础用法

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

触发对象

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

触发方式

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

菜单隐藏方式

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

指令事件

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

下拉方法

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

尺寸

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

属性名说明类型可选值默认值
type菜单按钮类型,同 Button 组件一样,仅在 split-button 为 true 的情况下有效。string
size菜单尺寸,在 split-button 为 true 的情况下也对触发按钮生效。stringlarge / default / smalldefault
max-height菜单最大高度string / number
split-button下拉触发元素呈现为按钮组booleanfalse
disabled是否禁用booleanfalse
placement菜单弹出位置stringtop/top-start/top-end/bottom/bottom-start/bottom-endbottom
trigger触发下拉的行为stringhover/click/contextmenuhover
hide-on-click是否在点击菜单项后隐藏菜单booleantrue
show-timeout展开下拉菜单的延时,仅在 trigger 为 hover 时有效number250
hide-timeout收起下拉菜单的延时(仅在 trigger 为 hover 时有效)number150
role下拉菜单的 ARIA 属性。 根据具体场景,您可能想要将此更改为“navigation”string'menu'
tabindexDropdown 组件的 tabindexnumber0
popper-class自定义浮层类名string
popper-optionspopper.js 参数Object请参考 popper.js 文档{modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]}
teleported是否将下拉列表插入至 body 元素booleantrue
插槽名说明子标签
下拉菜单的内容。 注意:必须是有效的 html DOM 元素(例如 <span>、<button> 等)或 el-component,以附加监听触发器
dropdown下拉列表,通常是 <el-dropdown-menu> 组件Dropdown-Menu
事件名说明参数
clicksplit-button 为 true 时,点击左侧按钮的回调
command点击菜单项触发的事件回调dropdown-item 的指令
visible-change下拉框出现/隐藏时触发出现则为 true,隐藏则为 false
方法名说明参数
handleOpen打开下拉菜单
handleClose关闭下拉菜单
插槽名说明子标签
下拉菜单的内容Dropdown-Item
属性名说明类型可选值默认值
command派发到command回调函数的指令参数string/number/object
disabled是否禁用booleanfalse
divided是否显示分隔符booleanfalse
icon自定义图标string | Component
插槽名说明
自定义Dropdown-Item内容

源代码

组件文档

贡献者