Dropdown 下拉菜单
将动作或菜单折叠到下拉菜单中。
基础用法
悬停在下拉菜单上以展开更多操作。
触发对象
可使用按钮触发下拉菜单。
触发方式
可以配置点击激活或者悬停激活。
菜单隐藏方式
可以通过 hide-on-click
属性来配置。
指令事件
点击菜单项后会触发事件,用户可以通过相应的菜单项 key 进行不同的操作。
下拉方法
您可以手动使用 手动打开
或 手动关闭下拉菜单以打开或关闭
尺寸
Dropdown 组件提供除了默认值以外的三种尺寸,可以在不同场景下选择合适的尺寸。
Dropdown API
Dropdown Attributes
属性名 | 说明 | 类型 | Default |
---|---|---|---|
type | 菜单按钮类型,同 Button 组件一样,仅在 split-button 为 true 的情况下有效。 | enum | '' |
size | 菜单尺寸,在 split-button 为 true 的情况下也对触发按钮生效。 | enum | '' |
max-height | 菜单最大高度 | string / number | '' |
split-button | 下拉触发元素呈现为按钮组 | boolean | false |
disabled | 是否禁用 | boolean | false |
placement | 菜单弹出位置 | enum | bottom |
trigger | 触发下拉的行为 | enum | hover |
hide-on-click | 是否在点击菜单项后隐藏菜单 | boolean | true |
show-timeout | 展开下拉菜单的延时,仅在 trigger 为 hover 时有效 | number | 150 |
hide-timeout | 收起下拉菜单的延时(仅在 trigger 为 hover 时有效) | number | 150 |
role | 下拉菜单的 ARIA 属性。 根据具体场景,您可能想要将此更改为“navigation” | string | menu |
tabindex | Dropdown 组件的 tabindex | number / string | 0 |
popper-class | 自定义浮层类名 | string | '' |
popper-options | popper.js 参数 | object | {modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]} |
teleported 2.2.20 | 是否将下拉列表插入至 body 元素 | boolean | true |
Dropdown 插槽
插槽名 | 说明 | 子标签 |
---|---|---|
default | 下拉菜单的内容。 注意:必须是有效的 html DOM 元素(例如 <span>、<button> 等)或 el-component ,以附加监听触发器 | — |
dropdown | 下拉列表,通常是 <el-dropdown-menu> 组件 | Dropdown-Menu |
Dropdown Events
事件名 | 说明 | 类型 |
---|---|---|
click | split-button 为 true 时,点击左侧按钮的回调 | Function |
command | 当下拉项被点击时触发,参数是从下拉菜单中发送的命令 | Function |
visible-change | 当下拉菜单出现/消失时触发器, 当它出现时, 参数将是 true , 否则将是 false | Function |
Dropdown Exposes
方法名 | 说明 | Type |
---|---|---|
handleOpen | 打开下拉菜单 | Function |
handleClose | 关闭下拉菜单 | Function |
Dropdown-Menu API
Dropdown-Menu Slots
插槽名 | 说明 | 子标签 |
---|---|---|
default | 下拉菜单的内容 | Dropdown-Item |
Dropdown-Item API
Dropdown-Item Attributes
属性名 | 说明 | Type | 默认值 |
---|---|---|---|
command | 派发到command 回调函数的指令参数 | string / number / object | — |
disabled | 是否禁用 | boolean | false |
divided | 是否显示分隔符 | boolean | false |
icon | 自定义图标 | string / Component | — |
Dropdown-Item Slots
插槽名 | 说明 |
---|---|
default | 自定义Dropdown-Item内容 |