OasisMenu is a lightweight and customizable context menu implementation for React. It allows users to easily add context menus to their projects, making it easier for users to access actions and options relevant to the context in which they are working.
If you're looking for more information on how to use OasisMenu, you can check out the following resources:
- Official Documentation - This is the official documentation for OasisMenu. It provides detailed information on how to use and customize the component.
- Demo Example - This is a live demo of the OasisMenu component in action. You can interact with the menu and see how it looks and behaves with the added styles and functionality.
To install OasisMenu, simply run the following command:
npm install oasismenu
To use OasisMenu, you'll need to import it into your React project and add it to the relevant components. Here's an example of how to use it:
import React from 'react';
import { OasisMenuBlock, OasisMenuTrigger, OasisMenu, OasisMenuItem, OasisMenuBreak } from 'oasismenu';
function App() {
return (
<>
<OasisMenuBlock>
<OasisMenuTrigger name="menu">
<button>Trigger button</button>
</OasisMenuTrigger>
<OasisMenu name="menu">
<OasisMenuItem onClick={() => alert("Menu Item 1")} content="Menu Item 1" />
<OasisMenuBreak />
<OasisMenuItem onClick={() => alert("Menu Item 2")} content="Menu Item 2" />
<OasisMenuBreak />
<OasisMenuItem onClick={() => alert("Menu Item 3")} content="Menu Item 3" />
</OasisMenu>
</OasisMenuBlock>
</>
);
};
export default App;
This is just a basic layout. OasisMenu offers a wide range of customization options, so be sure to check out the official documentation to learn more.
The OasisMenuBlock
component should be placed once at the top level of your application as a parent where all the processing happens. This component acts as a container for all context menus and triggers within your application.
The OasisMenuTrigger
component is used to define the trigger element for your context menu. This can be any valid HTML element or custom React component. The name
prop is used to associate the trigger with a specific context menu.
The OasisMenu
component defines the content of your context menu. It can contain any number of OasisMenuItem
or OasisMenuBreak
components. The name
prop should be set to the same value as the name
prop of the corresponding OasisMenuTrigger
.
The OasisMenuItem
component defines a single item within your context menu. It can contain any valid HTML content, and the onClick
prop should be set to a function that will be executed when the item is clicked.
The OasisMenuBreak
component is used to insert a separator between items within your context menu.
If you'd like to contribute to OasisMenu, please feel free to submit a pull request or open an issue on the project's GitHub repository.
OasisMenu is released under the MIT license.