Package Exports

react-contextmenu

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-contextmenu) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

React ContextMenu

ContextMenu in React.

Installation

npm install --save react-contextmenu

Usage

You need to setup two things:

The ContextMenu
The Component on which the ContextMenu must be invoked.

import React from "react";
import ReactDOM from "react-dom";
import { ContextMenu, MenuItem, ContextMenuLayer } from "react-contextmenu";

//Component on which context-menu must be triggred
const MyComponent = ContextMenuLayer("some_unique_identifier")(
    React.createClass({
        render() {
            <div className="well"></div>
        }
    })
);

//The context-menu to be triggered
const MyContextMenu = React.createClass({
    render() {
        <ContextMenu identifier="some_unique_identifier" currentItem={this.currentItem}>
            <MenuItem data={"some_data"} onClick={this.handleClick}>
                ContextMenu Item 1
            </MenuItem>
            <MenuItem data={"some_data"} onClick={this.handleClickClick}>
                ContextMenu Item 2
            </MenuItem>
            <MenuItem divider />
            <MenuItem data={"some_data"} onClick={this.handleClickClick}>
                ContextMenu Item 3
            </MenuItem>
        </ContextMenu>
    },
    handleClick(e, data) {
        console.log(data);
    }
});

const MyApp = React.createClass({
    render() {
        <div>
            <MyComponent {...this.props}/>
            <MyContextMenu />
        </div>
    }
});

ReactDOM.render(<MyApp myProp={12}/>, document.getElementById("main"));

As you can see that the ContextMenu to be showed on any component is dependent on a unique identifier.

The ContextMenuLayer higher order function takes two parameters. First is the unique identifier (same as the one used on the ContextMenu) and second is (optional) a function that must return some data that will be passed on to the onClick method of the MenuItem. This helps in identifying the component on which context click occured.

See examples for more in detail usage.

##Styling

The styling can be apllied to using following classes.

react-context-menu : applied to menu root element.
react-context-menu-item : applied to menu items.
react-context-menu-link : applied to menu links inside items.
react-context-menu-wrapper : applied to wrapper around elements in ContextMenuLayer.
submenu : applied to items that are submenus.
disabled : applied to links (title in submenu) when they are disabled.
active : applied to title in submenu when submenu is open.

See react-context-menu.css for example.

API

The module exports the following:

ContextMenu
ContextMenuLayer
MenuItem
SubMenu

ContextMenu(props)

Type: React Component

Base Contextmenu Component.

props.identifier

Type: String required

A unique identifier for the menu.

ContextMenuLayer(identifier, configure)

Type: Function

Return: Function

A Higher Order function that returns a function which in turn can be used to create a React Component on which the context menu must be triggered.

identifier

Type: String required

The unique identifier of the menu to be called.

configure

Type: Function optional

A simple function which takes props as input and returns the data to be passed to contextmenu.

MenuItem(props)

Type: React Component

A Simple Wrapper around menu items.

props.data

Type: Object optional

Default: {}

The extra data (if required) to be passed to onClick event.

props.disabled

Type: Boolean optional

Default: false

If true, disables the click event and adds .disabled class.

props.onClick

Type: Function required

The function to be called on click of item. The function will receive two parameters. The first is event object and the second is the extra data passed either using props.data or configure from ContextMenuLayer.

props.preventClose

Type: Boolean optional

Default: false

By default, the context menu is closed as soon as an item is clicked. Set this prop to control this behavior.

SubMenu(props)

props.title

Type: String required

The content to be displayed in parent menu.

props.hoverDelay

Type: Number optional

Default: 500

The time (in ms) after which the menu is to be displayed when hovered upon.

props.disabled

Type: Boolean optional

Default: false

If true, disables the menu from opening and adds .disabled class.

Credits

This project is based on the ideas from react-dnd by Dan Abramov.