You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<aid="github-forkme" href="https://github.com/medialize/jQuery-contextMenu"><imgsrc="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>
<imgsrc="screenshots/jquery-contextMenu.subs.png" alt="context menu rendered by $.contextMenu">
<imgsrc="screenshots/native.firefox-9.0a1.png" alt="Native context menu in Firefox 9.0 Alpha 1">
<!-- img src="screenshots/jquery-contextMenu.png" alt="context menu rendered by $.contextMenu" -->
</p>
<p>
The contextMenu Plugin was designed for web applications in need of menus on a possibly large amount of objects.
Unlike implementations as <ahref="http://abeautifulsite.net/blog/2008/09/jquery-context-menu-plugin/" target="_blank">a beautiful site's</a> or <ahref="http://www.trendskitchens.co.nz/jquery/contextmenu/" target="_blank">trendskitchens'</a> this contextMenu treats the menu as the primary object. That means, that a single menu is defined that can be used by multiple objects. Unlike the mentioned plugins, contextMenu doesn't need to bind itself to triggering objects. This allows injecting and removing triggers without having to re-initialize or update contextMenu.
</p>
<p>
contextMenu can provide a simple list of clickable commands, or offer an in-menu form. This makes very simple attribute modification possible. See the <ahref="demo/input.html">input example</a>.
</p>
<p>
Once a menu is registered, it cannot be altered. That means no commands can be added or removed from the menu. This allows contextMenu to keep a single definition in memory, which enables it to work with hundreds of trigger objects. contextMenu knows the two callbacks <em>show</em> and <em>hide</em> which can be used to update the state of commands within the menu. This allows en/disabling commands, changing icons or updating the values of contained <input> elements.
</p>
<p>
As of version 1.5 context menus can be created dynamically. That means the afore described behavior (once created, cannot be altered) still applies - but can be circumvented. Menus can be created on demand and they can be different depending on the triggering element.
</p>
<p>
And, yes, the icons provided in this demo are taken from a <ahref="http://abeautifulsite.net/blog/2008/09/jquery-context-menu-plugin/">beautiful site</a>,
as well as some implementation ideas...
</p>
<h2id="features">Features</h2>
<ul>
<li>trigger contextMenu with right-click, <ahref="demo/trigger-left-click.html">left-click</a>, <ahref="demo/trigger-hover.html">hover</a> or own <ahref="demo/trigger-custom.html">custom trigger</a> events</li>
<li>delegated event handling removing the need for re-initialization when trigger objects are <ahref="demo/dynamic.html">added / removed</a></li>
<li>dynamic <ahref="demo/dynamic-create.html">on-demand</a> menu creation</li>
<li>optional icons for commands</li>
<li><ahref="demo/input.html">input elements</a> (text, textarea, checkbox, radio, select) within the menu</li>
<li>custom html elements (command free)</li>
<li>show/hide callbacks to update the state of commands</li>
<li>small memory footprint even with hundreds of trigger objects</li>
<li>adjust position of menu to fit in viewport</li>
<li><ahref="https://github.com/christiaan">Christian Baartse</a> (single callback per menu)</li>
<li><ahref="https://github.com/addyosmani">Addy Osmani</a> (compatibility with native context menu in Firefox 8)</li>
</ul>
<h2id="license">License</h2>
<p>$.contextMenu is published under the <ahref="http://www.opensource.org/licenses/mit-license">MIT license</a> and <ahref="http://opensource.org/licenses/GPL-3.0">GPL v3</a>.</p>
