Dropdown下拉菜单
Dropdown
下拉菜单
向下弹出的列表。
使用import{ Dropdown }from"antd"; |
何时使用
当页面上的操作命令过多时，用此组件可以收纳操作元素。点击或移入触点，会出现一个下拉菜单。可在列表中进行选择，并执行相应的命令。
- 用于收罗一组命令操作。
- Select 用于选择，而 Dropdown 是命令集合。
代码演示
Hover me
最简单的下拉菜单。
支持 6 个弹出位置。
Hover me
分割线和不可用菜单项。
Click me
默认是移入触发菜单，可以点击触发。
左边是按钮，右边是额外的相关功能菜单。可设置 icon 属性来修改右边的图标。
Cascading menu
传入的菜单里有多个层级。
Right Click on here
默认是移入触发菜单，可以点击鼠标右键触发。弹出菜单位置会跟随右键点击位置变动。
Selectable
添加 menu 中的 selectable 属性可以开启选择能力。
可以展示一个箭头。
设置 arrow 为 { pointAtCenter: true } 后，箭头将指向目标元素的中心。
Hover me, Click menu item
点击菜单项后会触发事件，用户可以通过相应的菜单项 key 进行不同的操作。
Hover me
使用 dropdownRender 对下拉菜单进行自由扩展。如果你并不需要 Menu 内容，请直接使用 Popover 组件。
Hover me
默认是点击关闭菜单，可以关闭此功能。
添加 loading 属性即可让按钮处于加载状态，最后两个按钮演示点击后进入加载状态。
API
通用属性参考：通用属性
Dropdown
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| arrow | 下拉框箭头是否显示 | boolean | { pointAtCenter: boolean } | false | |
| autoAdjustOverflow | 下拉框被遮挡时自动调整位置 | boolean | true | 5.2.0 |
| autoFocus | 打开后自动聚焦下拉框 | boolean | false | 4.21.0 |
| disabled | 菜单是否禁用 | boolean | - | |
| destroyPopupOnHide | 关闭后是否销毁 Dropdown | boolean | false | |
| dropdownRender | 自定义下拉框内容 | (menus: ReactNode) => ReactNode | - | 4.24.0 |
| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。示例 | (triggerNode: HTMLElement) => HTMLElement | () => document.body | |
| menu | 菜单配置项 | MenuProps | - | 4.24.0 |
| overlayClassName | 下拉根元素的类名称 | string | - | |
| overlayStyle | 下拉根元素的样式 | CSSProperties | - | |
| placement | 菜单弹出位置：bottom bottomLeft bottomRight top topLeft topRight | string | bottomLeft | |
| trigger | 触发下拉的行为，移动端不支持 hover | Array<click|hover|contextMenu> | [hover] | |
| open | 菜单是否显示，小于 4.23.0 使用 visible（为什么?） | boolean | - | 4.23.0 |
| onOpenChange | 菜单显示状态改变时调用，点击菜单按钮导致的消失不会触发。小于 4.23.0 使用 onVisibleChange（为什么?） | (open: boolean, info: { source: 'trigger' | 'menu' }) => void | - | info.source: 5.11.0 |
Dropdown.Button
属性与 Dropdown 的相同。还包含以下属性：
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| buttonsRender | 自定义左右两个按钮 | (buttons: ReactNode[]) => ReactNode[] | - | |
| loading | 设置按钮载入状态，和 Button 一致 | boolean | { delay: number, icon: ReactNode } | false | icon: 5.23.0 |
| danger | 设置危险按钮 | boolean | - | 4.23.0 |
| icon | 右侧的 icon | ReactNode | - | |
| size | 按钮大小，和 Button 一致 | large | middle | small | middle | |
| type | 按钮类型，和 Button 一致 | primary | dashed | link | text | default | default | |
| onClick | 点击左侧按钮的回调，和 Button 一致 | (event: React.MouseEvent<HTMLElement, MouseEvent>) => void | - |
注意
请确保 Dropdown 的子元素能接受 onMouseEnter、onMouseLeave、onFocus、onClick 事件。
主题变量（Design Token）
组件 Token如何定制？
| Token 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| paddingBlock | 下拉菜单纵向内边距 | undefined | PaddingBlock<string | number> | 5 |
| zIndexPopup | 下拉菜单 z-index | number | 1050 |