Dropdown下拉菜单
Dropdown
下拉菜单
向下弹出的列表。
使用import { Dropdown } from "antd"; |
- 组件总览
- 通用
- 布局
- 导航
- 数据录入
- 数据展示
- 反馈
- 其他
当页面上的操作命令过多时，用此组件可以收纳操作元素。点击或移入触点，会出现一个下拉菜单。可在列表中进行选择，并执行相应的命令。
最简单的下拉菜单。
支持 6 个弹出位置。
分割线和不可用菜单项。
默认是移入触发菜单，可以点击触发。
左边是按钮，右边是额外的相关功能菜单。可设置 icon 属性来修改右边的图标。
传入的菜单里有多个层级。
默认是移入触发菜单，可以点击鼠标右键触发。弹出菜单位置会跟随右键点击位置变动。
添加 menu 中的 selectable 属性可以开启选择能力。
可以展示一个箭头。
设置 arrow 为 { pointAtCenter: true } 后，箭头将指向目标元素的中心。
点击菜单项后会触发事件，用户可以通过相应的菜单项 key 进行不同的操作。
使用 dropdownRender 对下拉菜单进行自由扩展。如果你并不需要 Menu 内容，请直接使用 Popover 组件。
默认是点击关闭菜单，可以关闭此功能。
添加 loading 属性即可让按钮处于加载状态，最后两个按钮演示点击后进入加载状态。
通用属性参考：通用属性
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| arrow | 下拉框箭头是否显示 | boolean | { pointAtCenter: boolean } | false | |
| autoAdjustOverflow | 下拉框被遮挡时自动调整位置 | boolean | true | 5.2.0 |
| autoFocus | 打开后自动聚焦下拉框 | boolean | false | 4.21.0 |
| disabled | 菜单是否禁用 | boolean | - | |
关闭后是否销毁 Dropdown，使用 destroyOnHidden 替换 | boolean | false | ||
| destroyOnHidden | 关闭后是否销毁 Dropdown | boolean | false | 5.25.0 |
自定义下拉框内容，使用 popupRender 替换 | (menus: ReactNode) => ReactNode | - | 4.24.0 | |
| popupRender | 自定义弹出框内容 | (menus: ReactNode) => ReactNode | - | 5.25.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 的相同。还包含以下属性：
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| 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 事件。
| Token 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| paddingBlock | 下拉菜单纵向内边距 | undefined | PaddingBlock<string | number> | 5 |
| zIndexPopup | 下拉菜单 z-index | number | 1050 |
