Dropdown下拉菜单

    当页面上的操作命令过多时,用此组件可以收纳操作元素。点击或移入触点,会出现一个下拉菜单。可在列表中进行选择,并执行相应的命令。

    基本

    最简单的下拉菜单。

    Dropdown下拉菜单 - 图2

    分割线和不可用菜单项。

    1. const menu = (
    2. <Menu>
    3. <Menu.Item key="0">
    4. <a target="_blank" rel="noopener noreferrer" href="http://www.alipay.com/">
    5. 1st menu item
    6. </a>
    7. </Menu.Item>
    8. <Menu.Item key="1">
    9. <a target="_blank" rel="noopener noreferrer" href="http://www.taobao.com/">
    10. 2nd menu item
    11. </a>
    12. </Menu.Item>
    13. <Menu.Divider />
    14. <Menu.Item key="3" disabled>
    15. 3rd menu itemdisabled
    16. </Menu.Item>
    17. </Menu>
    18. );
    19. ReactDOM.render(
    20. <Dropdown overlay={menu}>
    21. <a className="ant-dropdown-link" href="#">
    22. Hover me <Icon type="down" />
    23. </a>
    24. </Dropdown>,
    25. mountNode,
    26. );

    触发事件

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

    1. import { Menu, Dropdown, Icon, message } from 'antd';
    2. const onClick = ({ key }) => {
    3. message.info(`Click on item ${key}`);
    4. };
    5. const menu = (
    6. <Menu onClick={onClick}>
    7. <Menu.Item key="1">1st menu item</Menu.Item>
    8. <Menu.Item key="2">2nd memu item</Menu.Item>
    9. <Menu.Item key="3">3rd menu item</Menu.Item>
    10. </Menu>
    11. );
    12. ReactDOM.render(
    13. <Dropdown overlay={menu}>
    14. <a className="ant-dropdown-link" href="#">
    15. Hover me, Click menu item <Icon type="down" />
    16. </a>
    17. </Dropdown>,
    18. mountNode,
    19. );

    传入的菜单里有多个层级。

    Dropdown下拉菜单 - 图5

    右键菜单

    默认是移入触发菜单,可以点击鼠标右键触发。

    1. import { Menu, Dropdown } from 'antd';
    2. const menu = (
    3. <Menu>
    4. <Menu.Item key="1">1st menu item</Menu.Item>
    5. <Menu.Item key="2">2nd menu item</Menu.Item>
    6. <Menu.Item key="3">3rd menu item</Menu.Item>
    7. </Menu>
    8. );
    9. ReactDOM.render(
    10. <Dropdown overlay={menu} trigger={['contextMenu']}>
    11. <span style={{ userSelect: 'none' }}>Right Click on Me</span>
    12. </Dropdown>,
    13. mountNode,
    14. );

    支持 6 个弹出位置。

    1. import { Menu, Dropdown, Button } from 'antd';
    2. const menu = (
    3. <Menu>
    4. <a target="_blank" rel="noopener noreferrer" href="http://www.alipay.com/">
    5. 1st menu item
    6. </a>
    7. </Menu.Item>
    8. <Menu.Item>
    9. <a target="_blank" rel="noopener noreferrer" href="http://www.taobao.com/">
    10. 2nd menu item
    11. </a>
    12. </Menu.Item>
    13. <Menu.Item>
    14. <a target="_blank" rel="noopener noreferrer" href="http://www.tmall.com/">
    15. 3rd menu item
    16. </Menu.Item>
    17. </Menu>
    18. );
    19. ReactDOM.render(
    20. <div>
    21. <Dropdown overlay={menu} placement="bottomLeft">
    22. <Button>bottomLeft</Button>
    23. </Dropdown>
    24. <Dropdown overlay={menu} placement="bottomCenter">
    25. <Button>bottomCenter</Button>
    26. </Dropdown>
    27. <Dropdown overlay={menu} placement="bottomRight">
    28. <Button>bottomRight</Button>
    29. </Dropdown>
    30. <br />
    31. <Dropdown overlay={menu} placement="topLeft">
    32. <Button>topLeft</Button>
    33. </Dropdown>
    34. <Dropdown overlay={menu} placement="topCenter">
    35. <Button>topCenter</Button>
    36. </Dropdown>
    37. <Dropdown overlay={menu} placement="topRight">
    38. <Button>topRight</Button>
    39. </Dropdown>
    40. </div>,
    41. mountNode,
    42. );

    Dropdown下拉菜单 - 图7

    触发方式

    1. import { Menu, Dropdown, Icon } from 'antd';
    2. const menu = (
    3. <Menu>
    4. <Menu.Item key="0">
    5. <a href="http://www.alipay.com/">1st menu item</a>
    6. </Menu.Item>
    7. <Menu.Item key="1">
    8. <a href="http://www.taobao.com/">2nd menu item</a>
    9. </Menu.Item>
    10. <Menu.Divider />
    11. <Menu.Item key="3">3rd menu item</Menu.Item>
    12. </Menu>
    13. );
    14. ReactDOM.render(
    15. <Dropdown overlay={menu} trigger={['click']}>
    16. <a className="ant-dropdown-link" href="#">
    17. Click me <Icon type="down" />
    18. </a>
    19. </Dropdown>,
    20. mountNode,
    21. );

    左边是按钮,右边是额外的相关功能菜单。可设置 icon 属性来修改右边的图标。

    1. import { Menu, Dropdown, Button, Icon, message } from 'antd';
    2. function handleButtonClick(e) {
    3. message.info('Click on left button.');
    4. console.log('click left button', e);
    5. }
    6. function handleMenuClick(e) {
    7. message.info('Click on menu item.');
    8. console.log('click', e);
    9. }
    10. const menu = (
    11. <Menu onClick={handleMenuClick}>
    12. <Menu.Item key="1">
    13. <Icon type="user" />
    14. 1st menu item
    15. </Menu.Item>
    16. <Menu.Item key="2">
    17. <Icon type="user" />
    18. 2nd menu item
    19. </Menu.Item>
    20. <Menu.Item key="3">
    21. <Icon type="user" />
    22. 3rd item
    23. </Menu.Item>
    24. </Menu>
    25. );
    26. ReactDOM.render(
    27. <div id="components-dropdown-demo-dropdown-button">
    28. Dropdown
    29. </Dropdown.Button>
    30. <Dropdown.Button overlay={menu} icon={<Icon type="user" />}>
    31. Dropdown
    32. </Dropdown.Button>
    33. <Dropdown.Button onClick={handleButtonClick} overlay={menu} disabled>
    34. Dropdown
    35. </Dropdown.Button>
    36. <Dropdown overlay={menu}>
    37. <Button>
    38. Button <Icon type="down" />
    39. </Button>
    40. </Dropdown>
    41. </div>,
    42. mountNode,
    43. );

    Dropdown下拉菜单 - 图9

    菜单隐藏方式

    默认是点击关闭菜单,可以关闭此功能。

    1. import { Menu, Dropdown, Icon } from 'antd';
    2. class OverlayVisible extends React.Component {
    3. state = {
    4. visible: false,
    5. };
    6. handleMenuClick = e => {
    7. if (e.key === '3') {
    8. this.setState({ visible: false });
    9. }
    10. };
    11. handleVisibleChange = flag => {
    12. this.setState({ visible: flag });
    13. };
    14. render() {
    15. const menu = (
    16. <Menu onClick={this.handleMenuClick}>
    17. <Menu.Item key="1">Clicking me will not close the menu.</Menu.Item>
    18. <Menu.Item key="2">Clicking me will not close the menu also.</Menu.Item>
    19. <Menu.Item key="3">Clicking me will close the menu</Menu.Item>
    20. </Menu>
    21. );
    22. return (
    23. <Dropdown
    24. overlay={menu}
    25. onVisibleChange={this.handleVisibleChange}
    26. visible={this.state.visible}
    27. >
    28. <a className="ant-dropdown-link" href="#">
    29. Hover me <Icon type="down" />
    30. </a>
    31. </Dropdown>
    32. );
    33. }
    34. }

    属性如下

    overlay 菜单使用 ,还包括菜单项 Menu.Item,分割线 Menu.Divider

    参数说明类型默认值版本
    disabled菜单是否禁用boolean-
    icon右侧的 iconReactNode-3.17.0
    overlay菜单Menu-
    placement菜单弹出位置:bottomLeft bottomCenter bottomRight topLeft topCenter topRightStringbottomLeft
    size按钮大小,和 一致string'default'
    trigger触发下拉的行为Array<click|hover|contextMenu>['hover']
    type按钮类型,和 Button 一致string'default'
    visible菜单是否显示boolean-
    onClick点击左侧按钮的回调,和 一致Function-
    onVisibleChange菜单显示状态改变时调用,参数为 visibleFunction-