Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
react-use-context-menu
Advanced tools
Readme
A React hook for easily creating custom Context Menus! The hooks takes care of the logic and creating the a11y attributes, you take care of the UI!
This module is distributed via npm which is bundled with node and
should be installed as one of your project's dependencies
:
npm install --save react-use-context-menu
or
yarn add react-use-context-menu
Basic usage:
import React from 'react'
import ReactDOM from 'react-dom'
import useContextMenu from 'react-use-context-menu'
function App() {
const [
bindMenu,
bindMenuItems,
useContextTrigger
] = useContextMenu();
const [bindTrigger] = useContextTrigger(});
return (
<div className="App">
<h1>useContextMenu</h1>
<h2 {...bindTrigger}>Right click me to see some magic happen!</h2>
<nav {...bindMenu}>
<div {...bindMenuItems}>First action</div>
<div {...bindMenuItems}>Second action</div>
<hr/>
<div {...bindMenuItems}>Last action</div>
</nav>
</div>
);
}
const [
bindMenu,
bindMenuItems,
useContextTrigger,
{
data, // the data collected by the collect function of useContextTrigger
coords, // a 2d Array [x, y] returning the coords of the point where the right click was triggered
setCoords, // manually set the coords of the menu
isVisible, // Boolean indicating if the menu is visible or not
setVisible, // manually set the context menu visible with setVisible(true) or hidden with setVisible(false)
}
] = useContextMenu({
rtl: false, // Optional, set to true to enable RightToLeft menu,
handleElementSelect: el => el.focus() // Handles the element being selected with keyboard. Optional, focus is the default behaviour
});
The first element of the result array is an Object used to bind the context menu element. It has 4 properties:
{
style, // Mandatory
ref, // Mandatory
role: "menu", // Optional, if you don't care about a11y 😠
tabIndex: -1 // same as above, also this is needed for keayboard navigation
}
Keep in mind that you need to spread this over an actual element (like a div or a nav), if you spread it to a Component, then the Component should take care of passing the props to the underlying wrapper element. If you as well need to access the ref of the element you can simply do:
<div {...bindMenu} ref={(el) => {
bindMenu.ref(el);
// you logic here
}}
The second element is an Object with 3 props:
{
ref, // Mandatory
role: "menuitem", // Optional, if you don't care about a11y 😠
tabIndex: -1 // same as above, also this is needed for keayboard navigation
}
used to bind the menu items. You can spread it or assign the props one by one. Same as above applies.
The third element of the result array is another hook which you should use to bind the trigger component(s), which is the component which will trigger the context menu when right clicked. It accepts an optional config object for fine tuning and advanced usage
const [bindTrigger] = useContextTrigger({
// those are the default values
disable: false, // disable the trigger
holdToDisplay: 1000, // time in ms after which the context menu will appear when holding the touch
posX: 0, // distance in pixel from which the context menu will appear related to the right click X coord
posY: 0, // distance in pixel from which the context menu will appear related to the right click y coord
mouseButton: MOUSE_BUTTON.RIGHT, // set to 0 for triggering the context menu with the left click
disableIfShiftIsPressed: false, // Self explanatory 😺
collect: () => 'useContextMenu is cool!' // collect data to be passed to the context menu, see the example to see this in action
});
You can check the example folder or this codesandbox for more advanced examples.
This is the first package implemented using hooks so far for what I've seen! Other packages are using components which requires lot of configuration and are way bigger in size. Also this is the smallest and most configurable 💃
This package have been deeply inspired by https://github.com/vkbansal/react-contextmenu, thanks a lot to @vkbansal! 🙏
MIT
FAQs
React hook for managing custom context menus!
The npm package react-use-context-menu receives a total of 144 weekly downloads. As such, react-use-context-menu popularity was classified as not popular.
We found that react-use-context-menu demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.