3.4 KiB
| currentMenu |
|---|
| introduction |
jQuery contextMenu
Contextmenu plugin & polyfill
The contextMenu Plugin was designed for web applications in need of menus on a possibly large amount of objects. Unlike implementations as a beautiful site's or trendskitchens' 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.
contextMenu can provide a simple list of clickable commands, or offer an in-menu form. This makes very simple attribute modification possible. See the input example.
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 show and hide 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.
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.
Features
- trigger contextMenu with right-click, left-click, hover or own custom trigger events
- delegated event handling removing the need for re-initialization when trigger objects are added / removed
- dynamic on-demand menu creation
- optional icons for commands
- input elements (text, textarea, checkbox, radio, select) within the menu
- custom html elements (command free)
- show/hide callbacks to update the state of commands
- small memory footprint even with hundreds of trigger objects
- adjust position of menu to fit in viewport
- enable / disable commands
- nested sub-menus
- full keyboard interaction
- HTML5
<menu>support - CSS is for styling, javascript is not...
Authors
- Björn Brala (SWIS)
- Rodney Rehm
- Christian Baartse (single callback per menu)
- Addy Osmani (compatibility with native context menu in Firefox 8)
License
$.contextMenu is published under the MIT license.