Difference between revisions of "GM.registerMenuCommand"

From GreaseSpot Wiki
Jump to navigationJump to search
Line 1: Line 1:

== Description ==
This method allows user scripts to add an item to the [[Greasemonkey_Manual:Monkey_Menu#The_Menu|User Script Commands]] menu.
Compatibility: [[Version_history#0.2.5|Greasemonkey 0.2.5+]]

== Syntax ==
== Syntax ==

Revision as of 19:38, 9 September 2011



function GM_registerMenuCommand( caption, commandFunc, accessKey )


String The caption to display on the menu item.
Function The function to call when this menu item is selected by the user.
String A single character that can be used to select command when the menu is open. It should be a letter in the caption. [1]


In Greasemonkey 0.9.2, this API was changed. Previously, it accepted five parameters including accelKey and accelModifiers which have been removed. See this page's history for a description of them. If a script passes all five parameters, in the old style, then the fifth argument is used for accessKey.




GM_registerMenuCommand("Hello, world (simple)", helloSimple);
GM_registerMenuCommand("Hello, world!", hello, "h");
GM_registerMenuCommand("Hello, world! (again)", hello2, "e", "shift alt", "w");

The last example is in the pre-0.9.2 format. The 4th and 5th arguments will be ignored in recent versions of Greasemonkey.

See Also

The GM_config @require library can handle many of the tasks that GM_registerMenuCommand is otherwise used for, in a more user-friendly manner.