Skip to content

vutran/react-offcanvas

Repository files navigation

React Off-Canvas

Off-canvas menus for React.

Installation

$ npm install --save react-offcanvas

Usage

Basic Usage

<OffCanvas
  width={300}
  transitionDuration={300}
  isMenuOpened={false}
  position={"left"}
  effect={"overlay"}
>
  <OffCanvasBody className={"my-body-class"} style={{ fontSize: "18px" }}>
    This is the canvas body.
  </OffCanvasBody>
  <OffCanvasMenu className={"my-menu-class"} style={{ fontWeight: "bold" }}>
    This is the canvas menu.
  </OffCanvasMenu>
</OffCanvas>

Within An Application

You'll need to hook up your application to handle the state for toggling the menu. Check out the basic example below:

"use strict";

import React, { Component } from "react";
import { OffCanvas, OffCanvasMenu, OffCanvasBody } from "react-offcanvas";

export default class App extends Component {
  componentWillMount() {
    // sets the initial state
    this.setState({
      isMenuOpened: false
    });
  }

  render() {
    return (
      <OffCanvas
        width={300}
        transitionDuration={300}
        effect={"parallax"}
        isMenuOpened={this.state.isMenuOpened}
        position={"right"}
      >
        <OffCanvasBody
          className={styles.bodyClass}
          style={{ fontSize: "30px" }}
        >
          <p>This is the main body container.</p>
          <p>
            <a href="#" onClick={this.handleClick.bind(this)}>
              Click here
            </a>{" "}
            to toggle the menu.
          </p>
        </OffCanvasBody>
        <OffCanvasMenu className={styles.menuClass}>
          <p>Placeholder content.</p>
          <ul>
            <li>Link 1</li>
            <li>Link 2</li>
            <li>Link 3</li>
            <li>Link 4</li>
            <li>Link 5</li>
            <li>
              <a href="#" onClick={this.handleClick.bind(this)}>
                Toggle Menu
              </a>
            </li>
          </ul>
        </OffCanvasMenu>
      </OffCanvas>
    );
  }

  handleClick() {
    // toggles the menu opened state
    this.setState({ isMenuOpened: !this.state.isMenuOpened });
  }
}

Components

OffCanvas

This is the main component you will be using to compose your body and menu.

Prop Type Default Description
width number 250 The width of the menu and off-canvas transition.
transitionDuration number 250 The time in ms for the transition.
isMenuOpened bool false Is the menu opened or not.
position string "left" Position the menu to the "left" or "right".
effect string "push" Choose menu effect. "push", "overlay" or "parallax".

OffCanvasBody

Prop Type Default Description
width number 250 The width of the menu and off-canvas transition.
transitionDuration number 250 The time in ms for the transition.
isMenuOpened bool false Is the menu opened or not.
position string "left" Position the menu to the "left" or "right".
className string Custom className for the element.
style object CSS style object for the element.

OffCanvasMenu

Prop Type Default Description
width number 250 The width of the menu and off-canvas transition.
transitionDuration number 250 The time in ms for the transition.
isMenuOpened bool false Is the menu opened or not.
position string "left" Position the menu to the "left" or "right".
className string Custom className for the element.
style object CSS style object for the element.