Properties

  1. Dropdown.propTypes = {
  2. disabled: PropTypes.bool,
  3. direction: PropTypes.oneOf(['up', 'down', 'left', 'right']),
  4. group: PropTypes.bool,
  5. isOpen: PropTypes.bool,
  6. // For Dropdown usage inside a Nav
  7. nav: PropTypes.bool,
  8. active: PropTypes.bool,
  9. // For Dropdown usage inside a Navbar (disables popper)
  10. inNavbar: PropTypes.bool,
  11. tag: PropTypes.string, // default: 'div' unless nav=true, then 'li'
  12. toggle: PropTypes.func,
  13. setActiveFromChild: PropTypes.bool
  14. };
  15. DropdownToggle.propTypes = {
  16. caret: PropTypes.bool,
  17. color: PropTypes.string,
  18. className: PropTypes.string,
  19. disabled: PropTypes.bool,
  20. onClick: PropTypes.func,
  21. 'data-toggle': PropTypes.string,
  22. 'aria-haspopup': PropTypes.bool,
  23. // For DropdownToggle usage inside a Nav
  24. nav: PropTypes.bool,
  25. // Defaults to Button component
  26. tag: PropTypes.any
  27. };
  28. DropdownMenu.propTypes = {
  29. tag: PropTypes.string,
  30. children: PropTypes.node.isRequired,
  31. right: PropTypes.bool,
  32. flip: PropTypes.bool, // default: true,
  33. className: PropTypes.string,
  34. cssModule: PropTypes.object,
  35. // Custom modifiers that are passed to DropdownMenu.js, see https://popper.js.org/popper-documentation.html#modifiers
  36. modifiers: PropTypes.object,
  37. persist: PropTypes.bool, // presist the popper, even when closed. See #779 for reasoning
  38. // passed to popper, see
  39. positionFixed: PropTypes.bool
  40. };
  41. DropdownItem.propTypes = {
  42. children: PropTypes.node,
  43. active: PropTypes.bool,
  44. disabled: PropTypes.bool,
  45. divider: PropTypes.bool,
  46. tag: PropTypes.oneOfType([PropTypes.func, PropTypes.string]),
  47. header: PropTypes.bool,
  48. onClick: PropTypes.func,
  49. cssModule: PropTypes.object,
  50. toggle: PropTypes.bool // default: true
  51. };

To align the DropdownMenu to the right, add a right prop to Dropdown.

  1. <DropdownToggle caret>
  2. This dropdown's menu is right-aligned
  3. </DropdownToggle>
  4. <DropdownMenu right>
  5. <DropdownItem header>Header</DropdownItem>
  6. <DropdownItem disabled>Action</DropdownItem>
  7. <DropdownItem>Another Action</DropdownItem>
  8. <DropdownItem divider/>
  9. <DropdownItem>Another Action</DropdownItem>
  10. </DropdownMenu>
  11. </Dropdown>

Menu Headers

  1. <DropdownItem header>Header</DropdownItem>

Menu Dividers

  1. <DropdownItem>Action</DropdownItem>

Disabled Menu Items

  1. <DropdownItem disabled>Action</DropdownItem>

Sizing

Dropdowns - 图1

  1. <Dropdown group isOpen={this.state.dropdownOpen} size="lg" toggle={this.toggle}>
  2. <DropdownToggle caret>
  3. Dropdown
  4. </DropdownToggle>
  5. <DropdownMenu>
  6. ...
  7. </DropdownMenu>
  8. </Dropdown>
  9. <Dropdown isOpen={this.state.dropdownOpen} toggle={this.toggle}>
  10. <DropdownToggle caret>
  11. Dropdown
  12. </DropdownToggle>
  13. <DropdownMenu>
  14. ...
  15. </DropdownMenu>
  16. </Dropdown>
  17. <Dropdown group isOpen={this.state.dropdownOpen} size="sm" toggle={this.toggle}>
  18. <DropdownToggle caret>
  19. Dropdown
  20. </DropdownToggle>
  21. <DropdownMenu>
  22. ...
  23. </DropdownMenu>
  24. </Dropdown>

Custom Dropdown

Dropdowns - 图2

  1. import React from 'react';
  2. import { UncontrolledDropdown, DropdownToggle, DropdownMenu, DropdownItem } from 'reactstrap';
  3. export default function Example () {
  4. return (
  5. <UncontrolledDropdown>
  6. <DropdownToggle caret>
  7. Dropdown
  8. </DropdownToggle>
  9. <DropdownMenu>
  10. <DropdownItem header>Header</DropdownItem>
  11. <DropdownItem disabled>Action</DropdownItem>
  12. <DropdownItem>Another Action</DropdownItem>
  13. <DropdownItem divider />
  14. <DropdownItem>Another Action</DropdownItem>
  15. </DropdownMenu>
  16. </UncontrolledDropdown>
  17. );
  18. }

Drop direction variations

  1. <DropdownToggle caret>
  2. Dropup
  3. </DropdownToggle>
  4. <DropdownMenu>
  5. <DropdownItem>Another Action</DropdownItem>
  6. <DropdownItem>Another Action</DropdownItem>
  7. </DropdownMenu>
  8. </Dropdown>
  9. <Dropdown direction="left" isOpen={this.state.btnDropleft} toggle={() => { this.setState({ btnDropleft: !this.state.btnDropleft }); }}>
  10. <DropdownToggle caret>
  11. Dropleft
  12. </DropdownToggle>
  13. <DropdownMenu>
  14. <DropdownItem>Another Action</DropdownItem>
  15. <DropdownItem>Another Action</DropdownItem>
  16. </DropdownMenu>
  17. </Dropdown>
  18. <Dropdown direction="right" isOpen={this.state.btnDropright} toggle={() => { this.setState({ btnDropright: !this.state.btnDropright }); }}>
  19. <DropdownToggle caret>
  20. Dropright
  21. </DropdownToggle>
  22. <DropdownMenu>
  23. <DropdownItem>Another Action</DropdownItem>
  24. <DropdownItem>Another Action</DropdownItem>
  25. </DropdownMenu>
  26. </Dropdown>

Modifiers

  1. <Dropdown isOpen={isOpen} toggle={toggle}>
  2. <DropdownToggle>
  3. Dropdown
  4. </DropdownToggle>
  5. <DropdownMenu
  6. modifiers={{
  7. setMaxHeight: {
  8. enabled: true,
  9. order: 890,
  10. fn: (data) => {
  11. return {
  12. ...data,
  13. styles: {
  14. ...data.styles,
  15. overflow: 'auto',
  16. maxHeight: 100,
  17. },
  18. };
  19. },
  20. },
  21. }}
  22. >
  23. <DropdownItem>Another Action</DropdownItem>
  24. <DropdownItem>Another Action</DropdownItem>
  25. <DropdownItem>Another Action</DropdownItem>
  26. <DropdownItem>Another Action</DropdownItem>
  27. <DropdownItem>Another Action</DropdownItem>
  28. <DropdownItem>Another Action</DropdownItem>
  29. <DropdownItem>Another Action</DropdownItem>
  30. <DropdownItem>Another Action</DropdownItem>
  31. <DropdownItem>Another Action</DropdownItem>
  32. <DropdownItem>Another Action</DropdownItem>
  33. </DropdownMenu>
  34. </Dropdown>

Use setActiveFromChild prop to automatically set the dropdown to active when any of the dropdown menu items are active. Note: this prop will not work in conjunction with react-router Link and .