Skip to content
This repository has been archived by the owner on Jul 22, 2020. It is now read-only.

tropical32/react-dropdown-overflow

Repository files navigation

Links

example: https://github.com/dydokamil/react-dropdown-example

demo: https://dydokamil.github.io/react-dropdown-example/

npm: https://www.npmjs.com/package/react-dropdown-overflow

Demo

alt text

Installation

yarn add react-dropdown-overflow

or

npm install react-dropdown-overflow

Importing

import Dropdown from 'react-dropdown-overflow'

Usage

import Dropdown from 'react-dropdown-overflow'

class MyComponent extends React.Component {
  render() {
    <Dropdown dropdown={
      <div className='dropdown-list'>
        <ul>
         <li>item1</li>
         <li>item2</li>
         <li>item3</li>
       </ul>
      </div>
    }>
      <button>Toggler</button>
    </Dropdown>
  }
}

Props

mode?: "hover" | "click" = "hover"

Sets the behavior of the toggling element. Defaults to hover. Valid values are:

hover | click :: Whether the dropdown is triggered with a mouse click or on hover event.


children: ReactNode

A React component responsible for the toggling of the dropdown.


dropdown: ReactNode

A React component to be displayed as a dropdown.


positioning?: "center" | "left" | "right" = "left"

A string prop responsible for the positioning of the menu. Valid values are:

left | center | right :: The position of the dropdown menu.


zIndex?: "auto" | number = "auto"

A number specifying the z-index of the dropdown. Valid values are numbers.


hasClickOutsideListener?: boolean = false

A boolean prop specifying whether the dropdown should be closed when the mouse event is located outside of the entire component. Useful with click mode.


wrapperId?: string = undefined

id of the newly created element wrapping the children prop.


className?: string = "dropdown"

Class name of the newly created element wrapping the dropdown.


dropdownWrapperId?: string = undefined

id of the newly created element wrapping the dropdown.


isOpen?: boolean = undefined

A boolean prop responsible for the state of the component (closed/open). Valid values are:

true | false :: Whether the menu is visible.

WARNING: This changes the component from an uncontrolled to a controlled one.

About

A react dropdown that pops outside of the parent container with overflow.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published