docs.rs failed to build tauri-plugin-context-menu-0.1.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Visit the last successful build: tauri-plugin-context-menu-0.8.2

Tauri Plugin Context Menu

A Tauri plugin to display native context menu. The default Tauri API does not support context menu, so this plugin is created to fill the gap.

Screenshot

Support

All non-supported listed features are intended as future development.

	MacOS	Windows	Linux
Usability	✅	❌	❌
Submenu	✅	❌	❌
Disabled	✅	❌	❌
Callback	✅	❌	❌
Shortcut	✅	❌	❌
Icon	🔜	❌	❌
Separator	🔜	❌	❌

Installation

Crate: https://crates.io/crates/tauri-plugin-context-menu

cargo add tauri-plugin-context-menu to add the package.

Or add the following to your Cargo.toml for the latest unpublished version (not recommanded).

tauri-plugin-context-menu = { git = "https://github.com/c2r0b/tauri-plugin-context-menu", branch = "main" }

See "Using a Plugin" Tauri official guide to initialize the plugin.

Run Example

A vanilla JS example is provided in examples/vanilla. To run the example, run the following commands:

cd examples/vanilla
npm run tauri dev

Sample Usage

import { invoke } from "@tauri-apps/api";
import { listen } from "@tauri-apps/api/event";

window.addEventListener("contextmenu", (e) => {
    e.preventDefault();

    // Show the context menu
    invoke("plugin:context_menu|show_context_menu", {
        items: [
            {
                label: "Item 1",
                disabled: false,
                event: "item1clicked",
                shortcut: "ctrl+M"
                subitems: [
                    {
                        label: "Subitem 1",
                        disabled: false,
                        event: "subitem1clicked",
                    },
                    {
                        label: "Subitem 2",
                        disabled: false,
                        event: "subitem2clicked",
                    }
                ]
            }
        ],
    });

    // Listen to the event emitted when the first menu item is clicked
    listen("item1clicked", () => {
        alert("item 1 clicked");
    });
});

Options

List of options that can be passed to the plugin.

Option	Type	Description
items	`MenuItem[]`	List of menu items to be displayed.
pos	`Position`	Position of the menu. Default to the cursor position.

MenuItem

Option	Type	Description
label	`string`	Displayed test of the menu item.
disabled	`boolean`	Whether the menu item is disabled.
event	`string`	Event name to be emitted when the menu item is clicked.
subitems	`MenuItem[]`	List of sub menu items to be displayed.
shortcut	`string`	Keyboard shortcut displayed on the right.

Position

Position coordinates are relative to the currently active window.

Option	Type	Description
x	`number`	X position of the menu.
y	`number`	Y position of the menu.

tauri-plugin-context-menu 0.1.0