mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-21 04:48:02 +08:00
6a62d9e7ea
* fix(dropdown): dropdown menu title content style * chore: update rc-mentions to version 2.17.0 and rc-tabs to version 15.4.0 * test: add extra style debug * test: snap * test: snap * Refactor menu demo: remove extra-style-debug component and rename extra-style-debug files to extra-style * Refactor menu demo: remove extra-style-debug component and rename extra-style-debug files to extra-style * Refactor dropdown and menu styles: Add width to extra-style elements * test: snap * fix: Add Space component to menu demo The Space component was missing from the import statement in the menu demo file. This caused a compilation error. The fix adds the Space component to the import statement, resolving the issue. Refactor the menu demo to use Space component for vertical spacing between menus. This improves the visual layout and readability of the menus. Fixes #51492 * test: snap * refactor: Update dropdown and menu title content class names --------- Co-authored-by: afc163 <afc163@gmail.com>
153 lines
7.8 KiB
Markdown
153 lines
7.8 KiB
Markdown
---
|
||
category: Components
|
||
group: Navigation
|
||
title: Menu
|
||
description: A versatile menu for navigation.
|
||
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*KeyQQL5iKkkAAAAAAAAAAAAADrJ8AQ/original
|
||
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*Vn4XSqJFAxcAAAAAAAAAAAAADrJ8AQ/original
|
||
---
|
||
|
||
## When To Use
|
||
|
||
Navigation is an important part of any website, as a good navigation setup allows users to move around the site quickly and efficiently. Ant Design offers two navigation options: top and side. Top navigation provides all the categories and functions of the website. Side navigation provides the multi-level structure of the website.
|
||
|
||
More layouts with navigation: [Layout](/components/layout).
|
||
|
||
## Notes for developers
|
||
|
||
- Menu is rendered as a `ul` element, so it only supports [`li` and `script-supporting` elements](https://html.spec.whatwg.org/multipage/grouping-content.html#the-ul-element) as children nodes。Your customized node should be wrapped by `Menu.Item`.
|
||
- Menu needs to collect its node structure, so its children should be `Menu.*` or encapsulated HOCs.
|
||
|
||
## Examples
|
||
|
||
<!-- prettier-ignore -->
|
||
<code src="./demo/horizontal.tsx">Top Navigation</code>
|
||
<code src="./demo/horizontal-dark.tsx" debug>Top Navigation (dark)</code>
|
||
<code src="./demo/inline.tsx">Inline menu</code>
|
||
<code src="./demo/inline-collapsed.tsx">Collapsed inline menu</code>
|
||
<code src="./demo/sider-current.tsx">Open current submenu only</code>
|
||
<code src="./demo/vertical.tsx">Vertical menu</code>
|
||
<code src="./demo/theme.tsx">Menu Themes</code>
|
||
<code src="./demo/submenu-theme.tsx">Sub-menu theme</code>
|
||
<code src="./demo/switch-mode.tsx">Switch the menu type</code>
|
||
<code src="./demo/style-debug.tsx" debug>Style debug</code>
|
||
<code src="./demo/menu-v4.tsx" debug>Menu v4</code>
|
||
<code src="./demo/component-token.tsx" debug>Component Token</code>
|
||
<code src="./demo/extra-style.tsx" debug>Extra Style debug</code>
|
||
|
||
## API
|
||
|
||
Common props ref：[Common props](/docs/react/common-props)
|
||
|
||
### Menu
|
||
|
||
| Param | Description | Type | Default value | Version |
|
||
| --- | --- | --- | --- | --- |
|
||
| defaultOpenKeys | Array with the keys of default opened sub menus | string\[] | - | |
|
||
| defaultSelectedKeys | Array with the keys of default selected menu items | string\[] | - | |
|
||
| expandIcon | custom expand icon of submenu | ReactNode \| `(props: SubMenuProps & { isSubMenu: boolean }) => ReactNode` | - | 4.9.0 |
|
||
| forceSubMenuRender | Render submenu into DOM before it becomes visible | boolean | false | |
|
||
| inlineCollapsed | Specifies the collapsed status when menu is inline mode | boolean | - | |
|
||
| inlineIndent | Indent (in pixels) of inline menu items on each level | number | 24 | |
|
||
| items | Menu item content | [ItemType\[\]](#itemtype) | - | 4.20.0 |
|
||
| mode | Type of menu | `vertical` \| `horizontal` \| `inline` | `vertical` | |
|
||
| multiple | Allows selection of multiple items | boolean | false | |
|
||
| openKeys | Array with the keys of currently opened sub-menus | string\[] | - | |
|
||
| overflowedIndicator | Customized the ellipsis icon when menu is collapsed horizontally | ReactNode | `<EllipsisOutlined />` | |
|
||
| selectable | Allows selecting menu items | boolean | true | |
|
||
| selectedKeys | Array with the keys of currently selected menu items | string\[] | - | |
|
||
| style | Style of the root node | CSSProperties | - | |
|
||
| subMenuCloseDelay | Delay time to hide submenu when mouse leaves (in seconds) | number | 0.1 | |
|
||
| subMenuOpenDelay | Delay time to show submenu when mouse enters, (in seconds) | number | 0 | |
|
||
| theme | Color theme of the menu | `light` \| `dark` | `light` | |
|
||
| triggerSubMenuAction | Which action can trigger submenu open/close | `hover` \| `click` | `hover` | |
|
||
| onClick | Called when a menu item is clicked | function({ item, key, keyPath, domEvent }) | - | |
|
||
| onDeselect | Called when a menu item is deselected (multiple mode only) | function({ item, key, keyPath, selectedKeys, domEvent }) | - | |
|
||
| onOpenChange | Called when sub-menus are opened or closed | function(openKeys: string\[]) | - | |
|
||
| onSelect | Called when a menu item is selected | function({ item, key, keyPath, selectedKeys, domEvent }) | - | |
|
||
|
||
> More options in [rc-menu](https://github.com/react-component/menu#api)
|
||
|
||
### ItemType
|
||
|
||
> type ItemType = [MenuItemType](#menuitemtype) | [SubMenuType](#submenutype) | [MenuItemGroupType](#menuitemgrouptype) | [MenuDividerType](#menudividertype);
|
||
|
||
#### MenuItemType
|
||
|
||
| Param | Description | Type | Default value | Version |
|
||
| -------- | ------------------------------------ | --------- | ------------- | ------- |
|
||
| danger | Display the danger style | boolean | false | |
|
||
| disabled | Whether menu item is disabled | boolean | false | |
|
||
| extra | The extra of the menu item | ReactNode | - | 5.21.0 |
|
||
| icon | The icon of the menu item | ReactNode | - | |
|
||
| key | Unique ID of the menu item | string | - | |
|
||
| label | Menu label | ReactNode | - | |
|
||
| title | Set display title for collapsed item | string | - | |
|
||
|
||
#### SubMenuType
|
||
|
||
<!-- prettier-ignore -->
|
||
| Property | Description | Type | Default value | Version |
|
||
| --- | --- | --- | --- | --- |
|
||
| children | Sub-menus or sub-menu items | [ItemType\[\]](#itemtype) | - | |
|
||
| disabled | Whether sub-menu is disabled | boolean | false | |
|
||
| icon | Icon of sub menu | ReactNode | - | |
|
||
| key | Unique ID of the sub-menu | string | - | |
|
||
| label | Menu label | ReactNode | - | |
|
||
| popupClassName | Sub-menu class name, not working when `mode="inline"` | string | - | |
|
||
| popupOffset | Sub-menu offset, not working when `mode="inline"` | \[number, number] | - | |
|
||
| theme | Color theme of the SubMenu (inherits from Menu by default) | | `light` \| `dark` | - | |
|
||
| onTitleClick | Callback executed when the sub-menu title is clicked | function({ key, domEvent }) | - | |
|
||
|
||
#### MenuItemGroupType
|
||
|
||
Define `type` as `group` to make as group:
|
||
|
||
```ts
|
||
const groupItem = {
|
||
type: 'group', // Must have
|
||
label: 'My Group',
|
||
children: [],
|
||
};
|
||
```
|
||
|
||
| Param | Description | Type | Default value | Version |
|
||
| -------- | ---------------------- | --------------------------------- | ------------- | ------- |
|
||
| children | Sub-menu items | [MenuItemType\[\]](#menuitemtype) | - | |
|
||
| label | The title of the group | ReactNode | - | |
|
||
|
||
#### MenuDividerType
|
||
|
||
Divider line in between menu items, only used in vertical popup Menu or Dropdown Menu. Need define the `type` as `divider`：
|
||
|
||
```ts
|
||
const dividerItem = {
|
||
type: 'divider', // Must have
|
||
};
|
||
```
|
||
|
||
| Param | Description | Type | Default value | Version |
|
||
| ------ | ---------------------- | ------- | ------------- | ------- |
|
||
| dashed | Whether line is dashed | boolean | false | |
|
||
|
||
## FAQ
|
||
|
||
### Why will Menu's children be rendered twice?
|
||
|
||
Menu collects structure info with [twice-render](https://github.com/react-component/menu/blob/f4684514096d6b7123339cbe72e7b0f68db0bce2/src/Menu.tsx#L543) to support HOC usage. Merging into one render may cause the logic to become much more complex. Contributions to help improve the collection logic are welcomed.
|
||
|
||
### Why Menu do not responsive collapse in Flex layout?
|
||
|
||
Menu will render fully item in flex layout and then collapse it. You need tell flex not consider Menu width to enable responsive ([online demo](https://codesandbox.io/s/ding-bu-dao-hang-antd-4-21-7-forked-5e3imy?file=/demo.js)):
|
||
|
||
```jsx
|
||
<div style={{ flex }}>
|
||
<div style={{ ... }}>Some Content</div>
|
||
<Menu style={{ minWidth: 0, flex: "auto" }} />
|
||
</div>
|
||
```
|
||
|
||
## Design Token
|
||
|
||
<ComponentTokenTable component="Menu"></ComponentTokenTable>
|