Git Product home page Git Product logo

react-modern-drawer's Introduction

react-modern-drawer

creating drawers made easy!

NPM npm npm npm bundle size (version) npm bundle size (version) NPM

low bundle size with fantastic performance

Demo ๐Ÿ’ป๐Ÿ”ฅ

click here to see the demo

Browsers support

IE / Edge
IE / Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
iOS Safari
iOS Safari
Samsung
Samsung
Opera
Opera
All All All All All All All

Install

npm install --save react-modern-drawer

or if you are using yarn :

yarn add react-modern-drawer

Usage

import React from 'react'

// import component ๐Ÿ‘‡
import Drawer from 'react-modern-drawer'

//import styles ๐Ÿ‘‡
import 'react-modern-drawer/dist/index.css'

const App = () => {
    const [isOpen, setIsOpen] = React.useState(false)
    const toggleDrawer = () => {
        setIsOpen((prevState) => !prevState)
    }

    return (
        <>
            <button onClick={toggleDrawer}>Show</button>
            <Drawer
                open={isOpen}
                onClose={toggleDrawer}
                direction='right'
                className='bla bla bla'
            >
                <div>Hello World</div>
            </Drawer>
        </>
    )
}

export default App

API

api type required default value desciption
direction string yes "right" "right" , "left" , "top","bottom" Selecting the direction that drawer opens
open boolean yes false true , false Select when to show drawer
onClose function no ( )=>{ } any executable function This function is called when clicking on backdrop layer usually used for closing the drawer
size number or string no 250 integer or '{integer}px' or '{integer}vw' Determines the size of drawer
style React.CSSProperties no null Normal stylings Can be used for inline styles
duration number no 300 Any positive Integer Determines the duration of opening the drawer
overlayOpacity number no 0.4 Number between 0 and 1 Determines the opacity of overlay
overlayColor string no "#000" Any color code Determines the color of overlay
enableOverlay boolean no true true , false Determines whether to show the overlay
zIndex number no 100 Any positive Integer Determines the zIndex of drawer
children React.ReactNode no null Any ReactNode This is the same as props.children
className string no undefined - normal regular classNames and stuff
customIdSuffix string no A random string based on Math.random() - Used for making different ids for drawers, can be customized for special cases.
lockBackgroundScroll boolean no false - Locks the body scroll when drawer is open.

Support

If you like this package please consider giving it a star.

Contribution

clone the project and run yarn install then run yarn start to run the main project.

then cd example and run yarn start to start the development example in order to test the component.

any PRs are welcome!

License

MIT ยฉ Farzin-Firoozi

react-modern-drawer's People

Contributors

farzin-firoozi avatar thib3113 avatar yongtheskill avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.