Mercurial > kallithea
view pylons_app/public/js/yui/event-delegate/event-delegate.js @ 172:83c7ee1b5f5c
improved timerproxy with sqllogging, and new way of sqlformat queries
author | Marcin Kuzminski <marcin@python-works.com> |
---|---|
date | Fri, 21 May 2010 03:01:31 +0200 |
parents | 564e40829f80 |
children |
line wrap: on
line source
/* Copyright (c) 2009, Yahoo! Inc. All rights reserved. Code licensed under the BSD License: http://developer.yahoo.net/yui/license.txt version: 2.8.0r4 */ /** * Augments the Event Utility with a <code>delegate</code> method that * facilitates easy creation of delegated event listeners. (Note: Using CSS * selectors as the filtering criteria for delegated event listeners requires * inclusion of the Selector Utility.) * * @module event-delegate * @title Event Utility Event Delegation Module * @namespace YAHOO.util * @requires event */ (function () { var Event = YAHOO.util.Event, Lang = YAHOO.lang, delegates = [], getMatch = function(el, selector, container) { var returnVal; if (!el || el === container) { returnVal = false; } else { returnVal = YAHOO.util.Selector.test(el, selector) ? el: getMatch(el.parentNode, selector, container); } return returnVal; }; Lang.augmentObject(Event, { /** * Creates a delegate function used to call event listeners specified * via the <code>YAHOO.util.Event.delegate</code> method. * * @method _createDelegate * * @param {Function} fn The method (event listener) to call. * @param {Function|string} filter Function or CSS selector used to * determine for what element(s) the event listener should be called. * @param {Object} obj An arbitrary object that will be * passed as a parameter to the listener. * @param {Boolean|object} overrideContext If true, the value of the * obj parameter becomes the execution context * of the listener. If an object, this object * becomes the execution context. * @return {Function} Function that will call the event listener * specified by the <code>YAHOO.util.Event.delegate</code> method. * @private * @for Event * @static */ _createDelegate: function (fn, filter, obj, overrideContext) { return function (event) { var container = this, target = Event.getTarget(event), selector = filter, // The user might have specified the document object // as the delegation container, in which case it is not // nessary to scope the provided CSS selector(s) to the // delegation container bDocument = (container.nodeType === 9), matchedEl, context, sID, sIDSelector; if (Lang.isFunction(filter)) { matchedEl = filter(target); } else if (Lang.isString(filter)) { if (!bDocument) { sID = container.id; if (!sID) { sID = Event.generateId(container); } // Scope all selectors to the container sIDSelector = ("#" + sID + " "); selector = (sIDSelector + filter).replace(/,/gi, ("," + sIDSelector)); } if (YAHOO.util.Selector.test(target, selector)) { matchedEl = target; } else if (YAHOO.util.Selector.test(target, ((selector.replace(/,/gi, " *,")) + " *"))) { // The target is a descendant of an element matching // the selector, so crawl up to find the ancestor that // matches the selector matchedEl = getMatch(target, selector, container); } } if (matchedEl) { // The default context for delegated listeners is the // element that matched the filter. context = matchedEl; if (overrideContext) { if (overrideContext === true) { context = obj; } else { context = overrideContext; } } // Call the listener passing in the container and the // element that matched the filter in case the user // needs those. return fn.call(context, event, matchedEl, container, obj); } }; }, /** * Appends a delegated event listener. Delegated event listeners * receive three arguments by default: the DOM event, the element * specified by the filtering function or CSS selector, and the * container element (the element to which the event listener is * bound). (Note: Using the delegate method requires the event-delegate * module. Using CSS selectors as the filtering criteria for delegated * event listeners requires inclusion of the Selector Utility.) * * @method delegate * * @param {String|HTMLElement|Array|NodeList} container An id, an element * reference, or a collection of ids and/or elements to assign the * listener to. * @param {String} type The type of event listener to append * @param {Function} fn The method the event invokes * @param {Function|string} filter Function or CSS selector used to * determine for what element(s) the event listener should be called. * When a function is specified, the function should return an * HTML element. Using a CSS Selector requires the inclusion of the * CSS Selector Utility. * @param {Object} obj An arbitrary object that will be * passed as a parameter to the listener * @param {Boolean|object} overrideContext If true, the value of the obj parameter becomes * the execution context of the listener. If an * object, this object becomes the execution * context. * @return {Boolean} Returns true if the action was successful or defered, * false if one or more of the elements * could not have the listener attached, * or if the operation throws an exception. * @static * @for Event */ delegate: function (container, type, fn, filter, obj, overrideContext) { var sType = type, fnMouseDelegate, fnDelegate; if (Lang.isString(filter) && !YAHOO.util.Selector) { return false; } if (type == "mouseenter" || type == "mouseleave") { if (!Event._createMouseDelegate) { return false; } // Look up the real event--either mouseover or mouseout sType = Event._getType(type); fnMouseDelegate = Event._createMouseDelegate(fn, obj, overrideContext); fnDelegate = Event._createDelegate(function (event, matchedEl, container) { return fnMouseDelegate.call(matchedEl, event, container); }, filter, obj, overrideContext); } else { fnDelegate = Event._createDelegate(fn, filter, obj, overrideContext); } delegates.push([container, sType, fn, fnDelegate]); return Event.on(container, sType, fnDelegate); }, /** * Removes a delegated event listener. * * @method removeDelegate * * @param {String|HTMLElement|Array|NodeList} container An id, an element * reference, or a collection of ids and/or elements to remove * the listener from. * @param {String} type The type of event to remove. * @param {Function} fn The method the event invokes. If fn is * undefined, then all event listeners for the type of event are * removed. * @return {boolean} Returns true if the unbind was successful, false * otherwise. * @static * @for Event */ removeDelegate: function (container, type, fn) { var sType = type, returnVal = false, index, cacheItem; // Look up the real event--either mouseover or mouseout if (type == "mouseenter" || type == "mouseleave") { sType = Event._getType(type); } index = Event._getCacheIndex(delegates, container, sType, fn); if (index >= 0) { cacheItem = delegates[index]; } if (container && cacheItem) { returnVal = Event.removeListener(cacheItem[0], cacheItem[1], cacheItem[3]); if (returnVal) { delete delegates[index][2]; delete delegates[index][3]; delegates.splice(index, 1); } } return returnVal; } }); }()); YAHOO.register("event-delegate", YAHOO.util.Event, {version: "2.8.0r4", build: "2449"});