context.js

About

ContextJS is a lightweight solution for contextual menus. Currently, there are two versions.

The first is to be used with Twitters Bootstrap (bootstrap.css specifically). If you do not use or want to use bootstrap.css, there is a standalone stylesheet to give the menu it's base styles.

Features

• Linted: Valid JS
• Can be used with or without Twitters Bootstrap.css
• Event Based Links
• Anchor Links
• Headers
• Dividers
• Recursive Menus (infinite depth)
• Vertical Space Detection (turns into a "dropup")
• Horizontal Space Detection (Drops to the left instead of right)
• Add/Delete menus Dynamically

Public API

Initializing

context.init({
    fadeSpeed: 100,
    filter: function ($obj){},
    above: 'auto',
    preventDoubleContext: true,
    compress: false
});

Paramater	Type	Default	Description
fadeSpeed	int	100	The speed in which the context menu fades in (in milliseconds)
filter	function	null	Function that each finished list element will pass through for extra modification.
above	string || boolean	'auto'	If set to 'auto', menu will appear as a "dropup" if there is not enough room below it. Settings to true will make the menu a "popup" by default.
preventDoubleContext	boolean	true	If set to true, browser-based context menus will not work on contextjs menus.
compress	boolean	false	If set to true, context menus will have less padding, making them (hopefully) more unobtrusive

Updating Settings

context.settings({initSettings});

Paramater	Type	Default	Description
settings	object	null	The init settings can be placed in here to update context menus written to the DOM. Changing settings between attaching menus will give the menus their own options.

Attaching

context.attach('#download', [menuObjects]);

Paramater	Type	Default	Description
selector	string	null	The jQuery (or css) selector of the element you want to apply the context menu to
menuObjects	array	null	An array of objects that define the menus structure

Destroying

context.destroy('#download');

Paramater	Type	Default	Description
selector	string	null	The jQuery (or css) selector of the element you want to remove the context menu from

Menu Objects

Headers

{
	header: 'My Header Title'
}

Anchor Links

{
	text: 'My Link Title', 
	href: 'http://contextjs.com/', 
	target: '_blank'
}

Dividers

{
	divider: true
}

Event Based Actions

{
    text: 'Event Based Link',
    action: function(e){
    	e.preventDefault();
        alert('Do Something');
    }
}

Sub-Menus

{
    text: 'My Sub-menu',
    subMenu: [menuObjects]
}

Tracking Links with Google Analytics

{
	text: 'context.js', 
	href: 'http://contextjs.com/context.js', 
	target:'_blank', 
	action: function(e){
		_gaq.push(['_trackEvent', 'ContextJS Download', this.pathname, this.innerHTML]);
	}
}

Changelog

Version 1.0 (Initial Release)

Version 1.5

• Added Initialize Options
• Removal of Dropdown ID paramater
• Added Event-based items
• Added Headers
• Added Recursive Menus
• Vertical Space Detection

Version 2.0

• Refined Vertical Space Detection
• Added Horizontal Space Detection
• Added an optional standalone CSS file for use without bootstrap
• Added preventDoubleContext parameter in the init function
• Added target parameter to links
• Fixed event bubbling (multi-level dropdowns in the DOM)

Version 2.1

• Added settings function
• Added compressed code & styles
• Cleaned up context.js code

Version 2.1.1

• Fixed multiple menus becoming visible
• Refined Support for IE7 & IE8

Notes

• Stray trailing commas are disliked by IE. Make sure when creating your menu, you take that into account, elsewise, you will get the SCRIPT5007: Unable to get value of the property error.