contextmenu.js
Souce Code
/** * @class Creates a list of options which vary depending on the context in * which the menu is invoked. * @constructor * @extends YAHOO.widget.Menu * @base YAHOO.widget.Menu * @param {String or HTMLElement} p_oElement String id or HTMLElement * (either HTMLSelectElement or HTMLDivElement) of the source HTMLElement node. * @param {Object} p_oConfig Optional. The configuration object literal * containing the configuration for a ContextMenu instance. See * configuration class documentation for more details. */ YAHOO.widget.ContextMenu = function(p_oElement, p_oConfig) { YAHOO.widget.ContextMenu.superclass.constructor.call( this, p_oElement, p_oConfig ); }; YAHOO.extend(YAHOO.widget.ContextMenu, YAHOO.widget.Menu); YAHOO.widget.ContextMenu.prototype._oTrigger = null; /** * The ContextMenu class's initialization method. This method is automatically * called by the constructor, and sets up all DOM references for pre-existing * markup, and creates required markup if it is not already present. * @param {String or HTMLElement} p_oElement String id or HTMLElement * (either HTMLSelectElement or HTMLDivElement) of the source HTMLElement node. * @param {Object} p_oConfig Optional. The configuration object literal * containing the configuration for a ContextMenu instance. See * configuration class documentation for more details. */ YAHOO.widget.ContextMenu.prototype.init = function(p_oElement, p_oConfig) { if(!this.ITEM_TYPE) { this.ITEM_TYPE = YAHOO.widget.ContextMenuItem; } // Call the init of the superclass (YAHOO.widget.Menu) YAHOO.widget.ContextMenu.superclass.init.call(this, p_oElement); this.beforeInitEvent.fire(YAHOO.widget.ContextMenu); if(p_oConfig) { this.cfg.applyConfig(p_oConfig, true); } this.initEvent.fire(YAHOO.widget.ContextMenu); }; // Private event handlers /** * "mousedown" event handler for the document object. * @private * @param {Event} p_oEvent Event object passed back by the * event utility (YAHOO.util.Event). * @param {YAHOO.widget.ContextMenu} p_oMenu The ContextMenu instance * handling the event. */ YAHOO.widget.ContextMenu.prototype._onDocumentMouseDown = function(p_oEvent, p_oMenu) { var oTarget = YAHOO.util.Event.getTarget(p_oEvent); var oTargetEl = this._oTargetElement; if( oTarget != oTargetEl || !YAHOO.util.Dom.isAncestor(oTargetEl, oTarget) ) { this.hide(); } }; /** * "click" event handler for the HTMLElement node that triggered the event. * Used to cancel default behaviors in Opera. * @private * @param {Event} p_oEvent Event object passed back by the * event utility (YAHOO.util.Event). * @param {YAHOO.widget.ContextMenu} p_oMenu The ContextMenu instance * handling the event. */ YAHOO.widget.ContextMenu.prototype._onTriggerClick = function(p_oEvent, p_oMenu) { if(p_oEvent.ctrlKey) { YAHOO.util.Event.stopEvent(p_oEvent); } }; /** * "contextmenu" event handler ("mousedown" for Opera) for the HTMLElement * node that triggered the event. * @private * @param {Event} p_oEvent Event object passed back by the * event utility (YAHOO.util.Event). * @param {YAHOO.widget.ContextMenu} p_oMenu The ContextMenu instance * handling the event. */ YAHOO.widget.ContextMenu.prototype._onTriggerContextMenu = function(p_oEvent, p_oMenu) { var Event = YAHOO.util.Event; var oConfig = this.cfg; if(p_oEvent.type == "mousedown") { if(!p_oEvent.ctrlKey) { return; } Event.stopEvent(p_oEvent); } this.contextEventTarget = Event.getTarget(p_oEvent); // Position and display the context menu var nX = Event.getPageX(p_oEvent); var nY = Event.getPageY(p_oEvent); oConfig.applyConfig( { x:nX, y:nY, visible:true } ); oConfig.fireQueue(); // Prevent the browser's default context menu from appearing Event.preventDefault(p_oEvent); }; // Public properties /** * Returns the HTMLElement node that was the target of the "contextmenu" * DOM event. * @type HTMLElement */ YAHOO.widget.ContextMenu.prototype.contextEventTarget = null; // Public methods /** * Initializes the class's configurable properties which can be changed using * a ContextMenu instance's Config object (cfg). */ YAHOO.widget.ContextMenu.prototype.initDefaultConfig = function() { YAHOO.widget.ContextMenu.superclass.initDefaultConfig.call(this); // Add a configuration property this.cfg.addProperty("trigger", { handler: this.configTrigger }); }; // Event handlers for configuration properties /** * Event handler for when the "trigger" configuration property of * a MenuItem instance. * @param {String} p_sType The name of the event that was fired. * @param {Array} p_aArgs Collection of arguments sent when the * event was fired. * @param {YAHOO.widget.ContextMenu} p_oMenu The ContextMenu that instance fired * the event. */ YAHOO.widget.ContextMenu.prototype.configTrigger = function(p_sType, p_aArgs, p_oMenu) { var Event = YAHOO.util.Event; var oTrigger = p_aArgs[0]; if(oTrigger) { /* If there is a current "trigger" - remove the event handlers from that element(s) before assigning new ones */ if(this._oTrigger) { Event.purgeElement(this._oTrigger); } this._oTrigger = oTrigger; /* Listen for the "mousedown" event in Opera b/c it does not support the "contextmenu" event */ var bOpera = (this.browser == "opera"); Event.addListener( oTrigger, (bOpera ? "mousedown" : "contextmenu"), this._onTriggerContextMenu, this, true ); /* Assign a "click" event handler to the trigger element(s) for Opera to prevent default browser behaviors. */ if(bOpera) { Event.addListener( oTrigger, "click", this._onTriggerClick, this, true ); } // Assign a "mousedown" event handler to the document Event.addListener( document, "mousedown", this._onDocumentMouseDown, this, true ); } };