0.0.1 • Published 6 years ago

react-sidebar-styled v0.0.1

Weekly downloads
3
License
MIT
Repository
github
Last release
6 years ago

React Sidebar

Styled off-canvas sidebar component for React with a variety of CSS transitions.

NPM JavaScript Style Guide Travis

Install

npm install --save react-sidebar-styled
yarn add reactrix-sidebar-styled

Usage

  • Import the module along with the base styles
  • Pass desired props to component using spread operator
import React, { Component } from 'react'
import ReactSidebar from 'react-sidebar-styled'

class ReactSidebar extends Component {
  render () {
    const options = {
      side: "left",
      effect: "slide-out",
      speed: 250,
      timing: 'ease-in-out'
    }
    return (
      <Sidebar {...options}>
        <div>Menu Goes Here</div>
        <div>Page Goes Here</div>
      </Sidebar>
    )
  }
}

Features

  • Only one dependency (styled-components)
  • Only two peer depencies (react/prop-types)
  • Large selection of smooth transitions
  • Easy to use BEM class hooks

Examples

Props

PropTypeDefaultDescription: Options
sidestringleftMenu location: left right
effectstringslideTransition effect: slide push fall reveal diverge uncover shrink grow press
speednumber500Transition speed (milliseconds)
timingstringeaseTransition timing function:
overlaybooleantrueDisplay overlay: true false
iconsarray[ close, open ]Custom icons: [ component, component ]

Custom Icons

Set the icons prop equal to an array consisting of two components.

import { OpenIcon, CloseIcon } from './CustomIcons'
...
  const options = {
    icons: [ OpenIcon, CloseIcon ]
  }
...
  <Sidebar {...options} />
...

Classes

ClassDescription
.sidebarOuter component wrapper
.sidebar__containerInner component wrapper
.sidebar__menuOuter menu wrapper
.sidebar__pagePage content wrapper
.sidebar__overlayPage overlay
.sidebar__btn-openOpen menu button
.sidebar__btn-closeClose menu button

Development

Follow these steps to setup a local development environment. Use yarn or npm - not both. 1. Clone the repo from Github

git clone https://github.com/alexcasche/react-sidebar-styled
  1. Setup project & start rollup watch
npm install && npm start
yarn install && yarn add
  1. Setup react app & start dev server
cd example
npm install && npm start
yarn install && yarn start

Shoutouts

License

MIT © alexcasche