npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

kf-contextmenu

v1.5.0

Published

Context Menu implemented in React

Downloads

2

Readme

NPM version Build Status Dependency Status Dev Dependency Status Code Climate

React ContextMenu

ContextMenu in React.

Installation

npm install --save react-contextmenu

Usage

You need to setup two things:

  1. The ContextMenu
  2. 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.handleClick}>
                ContextMenu Item 2
            </MenuItem>
            <MenuItem divider />
            <MenuItem data={"some_data"} onClick={this.handleClick}>
                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
  • monitor
  • connect

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 Component for 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.

props.attributes

Type: Object optional

The attributes will be passed directly passed to the root element of MenuItem. Use this to customize it like adding custom classes, etc.

SubMenu(props)

Type: React Component

A component for using submenus within the contextmenu.

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.

monitor

Type: Object

A utility object.

monitor.getItem()

Type: Function

Returns: Object

A getter for the data passed to contextmenu, which is set using configure.

monitor.getPosition()

Type: Function

Returns: Object

Gives the position of the current or last active contextmenu.

monitor.hideMenu()

Type: Function

A utility function to hide the currently active contextmenu programmatically.

connect(Menu)

Type: Function

Returns: React Component

A simple wrapper to be used when different items must be rendered based on which component was (right) clicked.

Menu

Type: React Component

The Menu component that needs to be updated depending on the current selection. The component will receive object from monitor.getItem() in its props with item as key. All the other props will be simply passed through.

Customization

The higher order component created using ContextMenuLayer can accept the following props.

renderTag

Type: React Element (optional)

The element inside which the Component must be wrapped. By default div is used. But this prop can used to customize it.

attributes

Type: Object optional

The attributes will be passed directly passed to the root element of component. Use this to customize it like adding custom classes, adding colspan etc.

// following examples shows usage of `tr` instead of `div`

import { ContextMenuLayer } from "react-contextmenu";
import MenuTarget from "./menu-target";

const Item = ContextMenuLayer("identifier")(MenuTarget);

const App = React.createClass({
    render() {
        return (
            <table>
                <tbody>
                    {this.props.items.map((item, i) => (
                        <Item renderTag="tr" key={i} item={item}/>
                    ))}
                </tbody>
            </table>
        );
    }
});

Credits

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

License

MIT. Copyright(c) Vivek Kumar Bansal