event-base-debug.js revision 111837fe5c14f516f4a15878f9bbaf7bb0091364
03831d35f7499c87d51205817c93e9a8d42c4baestevel/*
03831d35f7499c87d51205817c93e9a8d42c4baestevel * DOM event listener abstraction layer
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @module event
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @submodule event-base
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel(function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel// Unlike most of the library, this code has to be executed as soon as it is
03831d35f7499c87d51205817c93e9a8d42c4baestevel// introduced into the page -- and it should only be executed one time
03831d35f7499c87d51205817c93e9a8d42c4baestevel// regardless of the number of instances that use it.
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevelvar stateChangeListener,
03831d35f7499c87d51205817c93e9a8d42c4baestevel GLOBAL_ENV = YUI.Env,
03831d35f7499c87d51205817c93e9a8d42c4baestevel config = YUI.config,
03831d35f7499c87d51205817c93e9a8d42c4baestevel doc = config.doc,
03831d35f7499c87d51205817c93e9a8d42c4baestevel docElement = doc.documentElement,
03831d35f7499c87d51205817c93e9a8d42c4baestevel doScrollCap = docElement.doScroll,
03831d35f7499c87d51205817c93e9a8d42c4baestevel add = YUI.Env.add,
03831d35f7499c87d51205817c93e9a8d42c4baestevel remove = YUI.Env.remove,
03831d35f7499c87d51205817c93e9a8d42c4baestevel targetEvent = (doScrollCap) ? 'onreadystatechange' : 'DOMContentLoaded',
03831d35f7499c87d51205817c93e9a8d42c4baestevel pollInterval = config.pollInterval || 40,
03831d35f7499c87d51205817c93e9a8d42c4baestevel _ready = function(e) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel GLOBAL_ENV._ready();
03831d35f7499c87d51205817c93e9a8d42c4baestevel };
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevelif (!GLOBAL_ENV._ready) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel GLOBAL_ENV._ready = function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (!GLOBAL_ENV.DOMReady) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel GLOBAL_ENV.DOMReady = true;
03831d35f7499c87d51205817c93e9a8d42c4baestevel remove(doc, targetEvent, _ready); // remove DOMContentLoaded listener
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel };
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel/*! DOMReady: based on work by: Dean Edwards/John Resig/Matthias Miller/Diego Perini */
03831d35f7499c87d51205817c93e9a8d42c4baestevel// Internet Explorer: use the doScroll() method on the root element. This isolates what
03831d35f7499c87d51205817c93e9a8d42c4baestevel// appears to be a safe moment to manipulate the DOM prior to when the document's readyState
03831d35f7499c87d51205817c93e9a8d42c4baestevel// suggests it is safe to do so.
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (doScrollCap) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (self !== self.top) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel stateChangeListener = function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (doc.readyState == 'complete') {
03831d35f7499c87d51205817c93e9a8d42c4baestevel remove(doc, targetEvent, stateChangeListener); // remove onreadystatechange listener
03831d35f7499c87d51205817c93e9a8d42c4baestevel _ready();
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel };
03831d35f7499c87d51205817c93e9a8d42c4baestevel add(doc, targetEvent, stateChangeListener); // add onreadystatechange listener
03831d35f7499c87d51205817c93e9a8d42c4baestevel } else {
03831d35f7499c87d51205817c93e9a8d42c4baestevel GLOBAL_ENV._dri = setInterval(function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel try {
03831d35f7499c87d51205817c93e9a8d42c4baestevel docElement.doScroll('left');
03831d35f7499c87d51205817c93e9a8d42c4baestevel clearInterval(GLOBAL_ENV._dri);
03831d35f7499c87d51205817c93e9a8d42c4baestevel GLOBAL_ENV._dri = null;
03831d35f7499c87d51205817c93e9a8d42c4baestevel _ready();
03831d35f7499c87d51205817c93e9a8d42c4baestevel } catch (domNotReady) { }
03831d35f7499c87d51205817c93e9a8d42c4baestevel }, pollInterval);
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel } else { // FireFox, Opera, Safari 3+ provide an event for this moment.
03831d35f7499c87d51205817c93e9a8d42c4baestevel add(doc, targetEvent, _ready); // add DOMContentLoaded listener
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel}
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel})();
03831d35f7499c87d51205817c93e9a8d42c4baestevelYUI.add('event-base', function(Y) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel(function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel/*
03831d35f7499c87d51205817c93e9a8d42c4baestevel * DOM event listener abstraction layer
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @module event
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @submodule event-base
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevelvar GLOBAL_ENV = YUI.Env,
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel yready = function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel Y.fire('domready');
03831d35f7499c87d51205817c93e9a8d42c4baestevel };
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel/**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The domready event fires at the moment the browser's DOM is
03831d35f7499c87d51205817c93e9a8d42c4baestevel * usable. In most cases, this is before images are fully
03831d35f7499c87d51205817c93e9a8d42c4baestevel * downloaded, allowing you to provide a more responsive user
03831d35f7499c87d51205817c93e9a8d42c4baestevel * interface.
03831d35f7499c87d51205817c93e9a8d42c4baestevel *
03831d35f7499c87d51205817c93e9a8d42c4baestevel * In YUI 3, domready subscribers will be notified immediately if
03831d35f7499c87d51205817c93e9a8d42c4baestevel * that moment has already passed when the subscription is created.
03831d35f7499c87d51205817c93e9a8d42c4baestevel *
03831d35f7499c87d51205817c93e9a8d42c4baestevel * One exception is if the yui.js file is dynamically injected into
03831d35f7499c87d51205817c93e9a8d42c4baestevel * the page. If this is done, you must tell the YUI instance that
03831d35f7499c87d51205817c93e9a8d42c4baestevel * you did this in order for DOMReady (and window load events) to
03831d35f7499c87d51205817c93e9a8d42c4baestevel * fire normally. That configuration option is 'injected' -- set
03831d35f7499c87d51205817c93e9a8d42c4baestevel * it to true if the yui.js script is not included inline.
03831d35f7499c87d51205817c93e9a8d42c4baestevel *
03831d35f7499c87d51205817c93e9a8d42c4baestevel * This method is part of the 'event-ready' module, which is a
03831d35f7499c87d51205817c93e9a8d42c4baestevel * submodule of 'event'.
03831d35f7499c87d51205817c93e9a8d42c4baestevel *
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @event domready
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @for YUI
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevelY.publish('domready', {
03831d35f7499c87d51205817c93e9a8d42c4baestevel fireOnce: true
03831d35f7499c87d51205817c93e9a8d42c4baestevel});
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevelif (GLOBAL_ENV.DOMReady) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel // console.log('DOMReady already fired', 'info', 'event');
03831d35f7499c87d51205817c93e9a8d42c4baestevel yready();
03831d35f7499c87d51205817c93e9a8d42c4baestevel} else {
03831d35f7499c87d51205817c93e9a8d42c4baestevel // console.log('setting up before listener', 'info', 'event');
03831d35f7499c87d51205817c93e9a8d42c4baestevel // console.log('env: ' + YUI.Env.windowLoaded, 'info', 'event');
03831d35f7499c87d51205817c93e9a8d42c4baestevel Y.before(yready, GLOBAL_ENV, "_ready");
03831d35f7499c87d51205817c93e9a8d42c4baestevel}
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel})();
03831d35f7499c87d51205817c93e9a8d42c4baestevel(function() {
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel/**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * Custom event engine, DOM event listener abstraction layer, synthetic DOM
03831d35f7499c87d51205817c93e9a8d42c4baestevel * events.
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @module event
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @submodule event-base
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel/**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * Wraps a DOM event, properties requiring browser abstraction are
03831d35f7499c87d51205817c93e9a8d42c4baestevel * fixed here. Provids a security layer when required.
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @class DOMEventFacade
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @param ev {Event} the DOM event
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @param currentTarget {HTMLElement} the element the listener was attached to
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @param wrapper {Event.Custom} the custom event wrapper for this DOM event
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel/*
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @TODO constants? LEFTBUTTON, MIDDLEBUTTON, RIGHTBUTTON, keys
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel/*
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevelvar whitelist = {
03831d35f7499c87d51205817c93e9a8d42c4baestevel altKey : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "button" : 1, // we supply
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "bubbles" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "cancelable" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "charCode" : 1, // we supply
03831d35f7499c87d51205817c93e9a8d42c4baestevel cancelBubble : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "currentTarget" : 1, // we supply
03831d35f7499c87d51205817c93e9a8d42c4baestevel ctrlKey : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel clientX : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel clientY : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel detail : 1, // not fully implemented
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "fromElement" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel keyCode : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "height" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "initEvent" : 1, // need the init events?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "initMouseEvent" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "initUIEvent" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "layerX" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "layerY" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel metaKey : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "modifiers" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "offsetX" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "offsetY" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "preventDefault" : 1, // we supply
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "reason" : 1, // IE proprietary
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "relatedTarget" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "returnValue" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel shiftKey : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "srcUrn" : 1, // IE proprietary
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "srcElement" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "srcFilter" : 1, IE proprietary
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "stopPropagation" : 1, // we supply
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "target" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "timeStamp" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "toElement" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel type : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "view" : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "which" : 1, // we supply
03831d35f7499c87d51205817c93e9a8d42c4baestevel // "width" : 1, // needed?
03831d35f7499c87d51205817c93e9a8d42c4baestevel x : 1,
03831d35f7499c87d51205817c93e9a8d42c4baestevel y : 1
03831d35f7499c87d51205817c93e9a8d42c4baestevel},
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel*/
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel var ua = Y.UA,
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * webkit key remapping required for Safari < 3.1
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property webkitKeymap
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @private
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel webkitKeymap = {
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63232: 38, // up
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63233: 40, // down
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63234: 37, // left
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63235: 39, // right
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63276: 33, // page up
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63277: 34, // page down
03831d35f7499c87d51205817c93e9a8d42c4baestevel 25: 9, // SHIFT-TAB (Safari provides a different key code in
03831d35f7499c87d51205817c93e9a8d42c4baestevel // this case, even though the shiftKey modifier is set)
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63272: 46, // delete
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63273: 36, // home
03831d35f7499c87d51205817c93e9a8d42c4baestevel 63275: 35 // end
03831d35f7499c87d51205817c93e9a8d42c4baestevel },
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * Returns a wrapped node. Intended to be used on event targets,
03831d35f7499c87d51205817c93e9a8d42c4baestevel * so it will return the node's parent if the target is a text
03831d35f7499c87d51205817c93e9a8d42c4baestevel * node.
03831d35f7499c87d51205817c93e9a8d42c4baestevel *
03831d35f7499c87d51205817c93e9a8d42c4baestevel * If accessing a property of the node throws an error, this is
03831d35f7499c87d51205817c93e9a8d42c4baestevel * probably the anonymous div wrapper Gecko adds inside text
03831d35f7499c87d51205817c93e9a8d42c4baestevel * nodes. This likely will only occur when attempting to access
03831d35f7499c87d51205817c93e9a8d42c4baestevel * the relatedTarget. In this case, we now return null because
03831d35f7499c87d51205817c93e9a8d42c4baestevel * the anonymous div is completely useless and we do not know
03831d35f7499c87d51205817c93e9a8d42c4baestevel * what the related target was because we can't even get to
03831d35f7499c87d51205817c93e9a8d42c4baestevel * the element's parent node.
03831d35f7499c87d51205817c93e9a8d42c4baestevel *
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @method resolve
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @private
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel resolve = function(n) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel try {
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (n && 3 == n.nodeType) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel n = n.parentNode;
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel } catch(e) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel return null;
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel return Y.one(n);
03831d35f7499c87d51205817c93e9a8d42c4baestevel };
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel// provide a single event with browser abstractions resolved
03831d35f7499c87d51205817c93e9a8d42c4baestevel//
03831d35f7499c87d51205817c93e9a8d42c4baestevel// include all properties for both browers?
03831d35f7499c87d51205817c93e9a8d42c4baestevel// include only DOM2 spec properties?
03831d35f7499c87d51205817c93e9a8d42c4baestevel// provide browser-specific facade?
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevelY.DOMEventFacade = function(ev, currentTarget, wrapper) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel wrapper = wrapper || {};
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel var e = ev, ot = currentTarget, d = Y.config.doc, b = d.body,
03831d35f7499c87d51205817c93e9a8d42c4baestevel x = e.pageX, y = e.pageY, c, t;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.altKey = e.altKey;
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.ctrlKey = e.ctrlKey;
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.metaKey = e.metaKey;
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.shiftKey = e.shiftKey;
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.type = e.type;
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.clientX = e.clientX;
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.clientY = e.clientY;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel //////////////////////////////////////////////////////
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (!x && 0 !== x) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel x = e.clientX || 0;
03831d35f7499c87d51205817c93e9a8d42c4baestevel y = e.clientY || 0;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (ua.ie) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel x += Math.max(d.documentElement.scrollLeft, b.scrollLeft);
03831d35f7499c87d51205817c93e9a8d42c4baestevel y += Math.max(d.documentElement.scrollTop, b.scrollTop);
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel this._yuifacade = true;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The native event
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property _event
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this._event = e;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The X location of the event on the page (including scroll)
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property pageX
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type int
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.pageX = x;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The Y location of the event on the page (including scroll)
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property pageY
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type int
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.pageY = y;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel //////////////////////////////////////////////////////
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel c = e.keyCode || e.charCode || 0;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel if (ua.webkit && (c in webkitKeymap)) {
03831d35f7499c87d51205817c93e9a8d42c4baestevel c = webkitKeymap[c];
03831d35f7499c87d51205817c93e9a8d42c4baestevel }
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The keyCode for key events. Uses charCode if keyCode is not available
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property keyCode
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type int
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.keyCode = c;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The charCode for key events. Same as keyCode
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property charCode
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type int
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.charCode = c;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel //////////////////////////////////////////////////////
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The button that was pushed.
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property button
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type int
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.button = e.which || e.button;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * The button that was pushed. Same as button.
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @property which
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type int
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.which = this.button;
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel //////////////////////////////////////////////////////
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * Node reference for the targeted element
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @propery target
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type Node
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.target = resolve(e.target || e.srcElement);
03831d35f7499c87d51205817c93e9a8d42c4baestevel
03831d35f7499c87d51205817c93e9a8d42c4baestevel /**
03831d35f7499c87d51205817c93e9a8d42c4baestevel * Node reference for the element that the listener was attached to.
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @propery currentTarget
03831d35f7499c87d51205817c93e9a8d42c4baestevel * @type Node
03831d35f7499c87d51205817c93e9a8d42c4baestevel */
03831d35f7499c87d51205817c93e9a8d42c4baestevel this.currentTarget = resolve(ot);
t = e.relatedTarget;
if (!t) {
if (e.type == "mouseout") {
t = e.toElement;
} else if (e.type == "mouseover") {
t = e.fromElement;
}
}
/**
* Node reference to the relatedTarget
* @propery relatedTarget
* @type Node
*/
this.relatedTarget = resolve(t);
/**
* Number representing the direction and velocity of the movement of the mousewheel.
* Negative is down, the higher the number, the faster. Applies to the mousewheel event.
* @property wheelDelta
* @type int
*/
if (e.type == "mousewheel" || e.type == "DOMMouseScroll") {
this.wheelDelta = (e.detail) ? (e.detail * -1) : Math.round(e.wheelDelta / 80) || ((e.wheelDelta < 0) ? -1 : 1);
}
//////////////////////////////////////////////////////
// methods
/**
* Stops the propagation to the next bubble target
* @method stopPropagation
*/
this.stopPropagation = function() {
if (e.stopPropagation) {
e.stopPropagation();
} else {
e.cancelBubble = true;
}
wrapper.stopped = 1;
};
/**
* Stops the propagation to the next bubble target and
* prevents any additional listeners from being exectued
* on the current target.
* @method stopImmediatePropagation
*/
this.stopImmediatePropagation = function() {
if (e.stopImmediatePropagation) {
e.stopImmediatePropagation();
} else {
this.stopPropagation();
}
wrapper.stopped = 2;
};
/**
* Prevents the event's default behavior
* @method preventDefault
* @param returnValue {string} sets the returnValue of the event to this value
* (rather than the default false value). This can be used to add a customized
* confirmation query to the beforeunload event).
*/
this.preventDefault = function(returnValue) {
if (e.preventDefault) {
e.preventDefault();
}
e.returnValue = returnValue || false;
wrapper.prevented = 1;
};
/**
* Stops the event propagation and prevents the default
* event behavior.
* @method halt
* @param immediate {boolean} if true additional listeners
* on the current target will not be executed
*/
this.halt = function(immediate) {
if (immediate) {
this.stopImmediatePropagation();
} else {
this.stopPropagation();
}
this.preventDefault();
};
};
})();
(function() {
/**
* DOM event listener abstraction layer
* @module event
* @submodule event-base
*/
/**
* The event utility provides functions to add and remove event listeners,
* event cleansing. It also tries to automatically remove listeners it
* registers during the unload event.
*
* @class Event
* @static
*/
Y.Env.evt.dom_wrappers = {};
Y.Env.evt.dom_map = {};
var _eventenv = Y.Env.evt,
add = YUI.Env.add,
remove = YUI.Env.remove,
onLoad = function() {
YUI.Env.windowLoaded = true;
Y.Event._load();
remove(window, "load", onLoad);
},
onUnload = function() {
Y.Event._unload();
remove(window, "unload", onUnload);
},
EVENT_READY = 'domready',
COMPAT_ARG = '~yui|2|compat~',
shouldIterate = function(o) {
try {
return (o && typeof o !== "string" && Y.Lang.isNumber(o.length) && !o.tagName && !o.alert);
} catch(ex) {
Y.log("collection check failure", "warn", "event");
return false;
}
},
Event = function() {
/**
* True after the onload event has fired
* @property _loadComplete
* @type boolean
* @static
* @private
*/
var _loadComplete = false,
/**
* The number of times to poll after window.onload. This number is
* increased if additional late-bound handlers are requested after
* the page load.
* @property _retryCount
* @static
* @private
*/
_retryCount = 0,
/**
* onAvailable listeners
* @property _avail
* @static
* @private
*/
_avail = [],
/**
* Custom event wrappers for DOM events. Key is
* 'event:' + Element uid stamp + event type
* @property _wrappers
* @type Y.Event.Custom
* @static
* @private
*/
_wrappers = _eventenv.dom_wrappers,
_windowLoadKey = null,
/**
* Custom event wrapper map DOM events. Key is
* Element uid stamp. Each item is a hash of custom event
* wrappers as provided in the _wrappers collection. This
* provides the infrastructure for getListeners.
* @property _el_events
* @static
* @private
*/
_el_events = _eventenv.dom_map;
return {
/**
* The number of times we should look for elements that are not
* in the DOM at the time the event is requested after the document
* has been loaded. The default is 1000@amp;40 ms, so it will poll
* for 40 seconds or until all outstanding handlers are bound
* (whichever comes first).
* @property POLL_RETRYS
* @type int
* @static
* @final
*/
POLL_RETRYS: 1000,
/**
* The poll interval in milliseconds
* @property POLL_INTERVAL
* @type int
* @static
* @final
*/
POLL_INTERVAL: 40,
/**
* addListener/removeListener can throw errors in unexpected scenarios.
* These errors are suppressed, the method returns false, and this property
* is set
* @property lastError
* @static
* @type Error
*/
lastError: null,
/**
* poll handle
* @property _interval
* @static
* @private
*/
_interval: null,
/**
* document readystate poll handle
* @property _dri
* @static
* @private
*/
_dri: null,
/**
* True when the document is initially usable
* @property DOMReady
* @type boolean
* @static
*/
DOMReady: false,
/**
* @method startInterval
* @static
* @private
*/
startInterval: function() {
if (!Event._interval) {
Event._interval = setInterval(Y.bind(Event._poll, Event), Event.POLL_INTERVAL);
}
},
/**
* Executes the supplied callback when the item with the supplied
* id is found. This is meant to be used to execute behavior as
* soon as possible as the page loads. If you use this after the
* initial page load it will poll for a fixed time for the element.
* The number of times it will poll and the frequency are
* configurable. By default it will poll for 10 seconds.
*
* <p>The callback is executed with a single parameter:
* the custom object parameter, if provided.</p>
*
* @method onAvailable
*
* @param {string||string[]} id the id of the element, or an array
* of ids to look for.
* @param {function} fn what to execute when the element is found.
* @param {object} p_obj an optional object to be passed back as
* a parameter to fn.
* @param {boolean|object} p_override If set to true, fn will execute
* in the context of p_obj, if set to an object it
* will execute in the context of that object
* @param checkContent {boolean} check child node readiness (onContentReady)
* @static
* @deprecated Use Y.on("available")
*/
// @TODO fix arguments
onAvailable: function(id, fn, p_obj, p_override, checkContent, compat) {
var a = Y.Array(id), i, availHandle;
// Y.log('onAvailable registered for: ' + id);
for (i=0; i<a.length; i=i+1) {
_avail.push({
id: a[i],
fn: fn,
obj: p_obj,
override: p_override,
checkReady: checkContent,
compat: compat
});
}
_retryCount = this.POLL_RETRYS;
// We want the first test to be immediate, but async
setTimeout(Y.bind(Event._poll, Event), 0);
availHandle = new Y.EventHandle({
_delete: function() {
// set by the event system for lazy DOM listeners
if (availHandle.handle) {
availHandle.handle.detach();
return;
}
var i, j;
// otherwise try to remove the onAvailable listener(s)
for (i = 0; i < a.length; i++) {
for (j = 0; j < _avail.length; j++) {
if (a[i] === _avail[j].id) {
_avail.splice(j, 1);
}
}
}
}
});
return availHandle;
},
/**
* Works the same way as onAvailable, but additionally checks the
* state of sibling elements to determine if the content of the
* available element is safe to modify.
*
* <p>The callback is executed with a single parameter:
* the custom object parameter, if provided.</p>
*
* @method onContentReady
*
* @param {string} id the id of the element to look for.
* @param {function} fn what to execute when the element is ready.
* @param {object} p_obj an optional object to be passed back as
* a parameter to fn.
* @param {boolean|object} p_override If set to true, fn will execute
* in the context of p_obj. If an object, fn will
* exectute in the context of that object
*
* @static
* @deprecated Use Y.on("contentready")
*/
// @TODO fix arguments
onContentReady: function(id, fn, p_obj, p_override, compat) {
return this.onAvailable(id, fn, p_obj, p_override, true, compat);
},
/**
* Adds an event listener
*
* @method attach
*
* @param {String} type The type of event to append
* @param {Function} fn The method the event invokes
* @param {String|HTMLElement|Array|NodeList} el An id, an element
* reference, or a collection of ids and/or elements to assign the
* listener to.
* @param {Object} context optional context object
* @param {Boolean|object} args 0..n arguments to pass to the callback
* @return {EventHandle} an object to that can be used to detach the listener
*
* @static
*/
attach: function(type, fn, el, context) {
return Event._attach(Y.Array(arguments, 0, true));
},
_createWrapper: function (el, type, capture, compat, facade) {
var cewrapper,
ek = Y.stamp(el),
key = 'event:' + ek + type;
if (false === facade) {
key += 'native';
}
if (capture) {
key += 'capture';
}
cewrapper = _wrappers[key];
if (!cewrapper) {
// create CE wrapper
cewrapper = Y.publish(key, {
silent: true,
bubbles: false,
contextFn: function() {
if (compat) {
return cewrapper.el;
} else {
cewrapper.nodeRef = cewrapper.nodeRef || Y.one(cewrapper.el);
return cewrapper.nodeRef;
}
}
});
// for later removeListener calls
cewrapper.el = el;
cewrapper.key = key;
cewrapper.domkey = ek;
cewrapper.type = type;
cewrapper.fn = function(e) {
cewrapper.fire(Event.getEvent(e, el, (compat || (false === facade))));
};
cewrapper.capture = capture;
if (el == Y.config.win && type == "load") {
// window load happens once
cewrapper.fireOnce = true;
_windowLoadKey = key;
}
_wrappers[key] = cewrapper;
_el_events[ek] = _el_events[ek] || {};
_el_events[ek][key] = cewrapper;
add(el, type, cewrapper.fn, capture);
}
return cewrapper;
},
_attach: function(args, config) {
var compat,
handles, oEl, cewrapper, context,
fireNow = false, ret,
type = args[0],
fn = args[1],
el = args[2] || Y.config.win,
facade = config && config.facade,
capture = config && config.capture;
if (args[args.length-1] === COMPAT_ARG) {
compat = true;
// trimmedArgs.pop();
}
if (!fn || !fn.call) {
// throw new TypeError(type + " attach call failed, callback undefined");
Y.log(type + " attach call failed, invalid callback", "error", "event");
return false;
}
// The el argument can be an array of elements or element ids.
if (shouldIterate(el)) {
handles=[];
Y.each(el, function(v, k) {
args[2] = v;
handles.push(Event._attach(args, config));
});
// return (handles.length === 1) ? handles[0] : handles;
return new Y.EventHandle(handles);
// If the el argument is a string, we assume it is
// actually the id of the element. If the page is loaded
// we convert el to the actual element, otherwise we
// defer attaching the event until the element is
// ready
} else if (Y.Lang.isString(el)) {
// oEl = (compat) ? Y.DOM.byId(el) : Y.Selector.query(el);
if (compat) {
oEl = Y.DOM.byId(el);
} else {
oEl = Y.Selector.query(el);
switch (oEl.length) {
case 0:
oEl = null;
break;
case 1:
oEl = oEl[0];
break;
default:
args[2] = oEl;
return Event._attach(args, config);
}
}
if (oEl) {
el = oEl;
// Not found = defer adding the event until the element is available
} else {
// Y.log(el + ' not found');
ret = this.onAvailable(el, function() {
// Y.log('lazy attach: ' + args);
ret.handle = Event._attach(args, config);
}, Event, true, false, compat);
return ret;
}
}
// Element should be an html element or node
if (!el) {
Y.log("unable to attach event " + type, "warn", "event");
return false;
}
if (Y.Node && el instanceof Y.Node) {
el = Y.Node.getDOMNode(el);
}
cewrapper = this._createWrapper(el, type, capture, compat, facade);
if (el == Y.config.win && type == "load") {
// if the load is complete, fire immediately.
// all subscribers, including the current one
// will be notified.
if (YUI.Env.windowLoaded) {
fireNow = true;
}
}
if (compat) {
args.pop();
}
context = args[3];
// set context to the Node if not specified
// ret = cewrapper.on.apply(cewrapper, trimmedArgs);
ret = cewrapper._on(fn, context, (args.length > 4) ? args.slice(4) : null);
if (fireNow) {
cewrapper.fire();
}
return ret;
},
/**
* Removes an event listener. Supports the signature the event was bound
* with, but the preferred way to remove listeners is using the handle
* that is returned when using Y.on
*
* @method detach
*
* @param {String} type the type of event to remove.
* @param {Function} fn the method the event invokes. If fn is
* undefined, then all event handlers for the type of event are
* removed.
* @param {String|HTMLElement|Array|NodeList|EventHandle} el An
* event handle, an id, an element reference, or a collection
* of ids and/or elements to remove the listener from.
* @return {boolean} true if the unbind was successful, false otherwise.
* @static
*/
detach: function(type, fn, el, obj) {
var args=Y.Array(arguments, 0, true), compat, l, ok, i,
id, ce;
if (args[args.length-1] === COMPAT_ARG) {
compat = true;
// args.pop();
}
if (type && type.detach) {
return type.detach();
}
// The el argument can be a string
if (typeof el == "string") {
// el = (compat) ? Y.DOM.byId(el) : Y.all(el);
if (compat) {
el = Y.DOM.byId(el);
} else {
el = Y.Selector.query(el);
l = el.length;
if (l < 1) {
el = null;
} else if (l == 1) {
el = el[0];
}
}
// return Event.detach.apply(Event, args);
}
if (!el) {
return false;
}
if (el.detach) {
args.splice(2, 1);
return el.detach.apply(el, args);
// The el argument can be an array of elements or element ids.
} else if (shouldIterate(el)) {
ok = true;
for (i=0, l=el.length; i<l; ++i) {
args[2] = el[i];
ok = ( Y.Event.detach.apply(Y.Event, args) && ok );
}
return ok;
}
if (!type || !fn || !fn.call) {
return this.purgeElement(el, false, type);
}
id = 'event:' + Y.stamp(el) + type;
ce = _wrappers[id];
if (ce) {
return ce.detach(fn);
} else {
return false;
}
},
/**
* Finds the event in the window object, the caller's arguments, or
* in the arguments of another method in the callstack. This is
* executed automatically for events registered through the event
* manager, so the implementer should not normally need to execute
* this function at all.
* @method getEvent
* @param {Event} e the event parameter from the handler
* @param {HTMLElement} el the element the listener was attached to
* @return {Event} the event
* @static
*/
getEvent: function(e, el, noFacade) {
var ev = e || window.event;
return (noFacade) ? ev :
new Y.DOMEventFacade(ev, el, _wrappers['event:' + Y.stamp(el) + e.type]);
},
/**
* Generates an unique ID for the element if it does not already
* have one.
* @method generateId
* @param el the element to create the id for
* @return {string} the resulting id of the element
* @static
*/
generateId: function(el) {
var id = el.id;
if (!id) {
id = Y.stamp(el);
el.id = id;
}
return id;
},
/**
* We want to be able to use getElementsByTagName as a collection
* to attach a group of events to. Unfortunately, different
* browsers return different types of collections. This function
* tests to determine if the object is array-like. It will also
* fail if the object is an array, but is empty.
* @method _isValidCollection
* @param o the object to test
* @return {boolean} true if the object is array-like and populated
* @deprecated was not meant to be used directly
* @static
* @private
*/
_isValidCollection: shouldIterate,
/**
* hook up any deferred listeners
* @method _load
* @static
* @private
*/
_load: function(e) {
if (!_loadComplete) {
// Y.log('Load Complete', 'info', 'event');
_loadComplete = true;
// Just in case DOMReady did not go off for some reason
// E._ready();
if (Y.fire) {
Y.fire(EVENT_READY);
}
// Available elements may not have been detected before the
// window load event fires. Try to find them now so that the
// the user is more likely to get the onAvailable notifications
// before the window load notification
Event._poll();
}
},
/**
* Polling function that runs before the onload event fires,
* attempting to attach to DOM Nodes as soon as they are
* available
* @method _poll
* @static
* @private
*/
_poll: function() {
if (this.locked) {
return;
}
if (Y.UA.ie && !YUI.Env.DOMReady) {
// Hold off if DOMReady has not fired and check current
// readyState to protect against the IE operation aborted
// issue.
this.startInterval();
return;
}
this.locked = true;
// Y.log.debug("poll");
// keep trying until after the page is loaded. We need to
// check the page load state prior to trying to bind the
// elements so that we can be certain all elements have been
// tested appropriately
var i, len, item, el, notAvail, executeItem,
tryAgain = !_loadComplete;
if (!tryAgain) {
tryAgain = (_retryCount > 0);
}
// onAvailable
notAvail = [];
executeItem = function (el, item) {
var context, ov = item.override;
if (item.compat) {
if (item.override) {
if (ov === true) {
context = item.obj;
} else {
context = ov;
}
} else {
context = el;
}
item.fn.call(context, item.obj);
} else {
context = item.obj || Y.one(el);
item.fn.apply(context, (Y.Lang.isArray(ov)) ? ov : []);
}
};
// onAvailable
for (i=0,len=_avail.length; i<len; ++i) {
item = _avail[i];
if (item && !item.checkReady) {
// el = (item.compat) ? Y.DOM.byId(item.id) : Y.one(item.id);
el = (item.compat) ? Y.DOM.byId(item.id) : Y.Selector.query(item.id, null, true);
if (el) {
// Y.log('avail: ' + el);
executeItem(el, item);
_avail[i] = null;
} else {
// Y.log('NOT avail: ' + el);
notAvail.push(item);
}
}
}
// onContentReady
for (i=0,len=_avail.length; i<len; ++i) {
item = _avail[i];
if (item && item.checkReady) {
// el = (item.compat) ? Y.DOM.byId(item.id) : Y.one(item.id);
el = (item.compat) ? Y.DOM.byId(item.id) : Y.Selector.query(item.id, null, true);
if (el) {
// The element is available, but not necessarily ready
// @todo should we test parentNode.nextSibling?
if (_loadComplete || (el.get && el.get('nextSibling')) || el.nextSibling) {
executeItem(el, item);
_avail[i] = null;
}
} else {
notAvail.push(item);
}
}
}
_retryCount = (notAvail.length === 0) ? 0 : _retryCount - 1;
if (tryAgain) {
// we may need to strip the nulled out items here
this.startInterval();
} else {
clearInterval(this._interval);
this._interval = null;
}
this.locked = false;
return;
},
/**
* Removes all listeners attached to the given element via addListener.
* Optionally, the node's children can also be purged.
* Optionally, you can specify a specific type of event to remove.
* @method purgeElement
* @param {HTMLElement} el the element to purge
* @param {boolean} recurse recursively purge this element's children
* as well. Use with caution.
* @param {string} type optional type of listener to purge. If
* left out, all listeners will be removed
* @static
*/
purgeElement: function(el, recurse, type) {
// var oEl = (Y.Lang.isString(el)) ? Y.one(el) : el,
var oEl = (Y.Lang.isString(el)) ? Y.Selector.query(el, null, true) : el,
lis = this.getListeners(oEl, type), i, len, props, children, child;
if (recurse && oEl) {
lis = lis || [];
children = Y.Selector.query('*', oEl);
i = 0;
len = children.length;
for (; i < len; ++i) {
child = this.getListeners(children[i], type);
if (child) {
lis = lis.concat(child);
}
}
}
if (lis) {
i = 0;
len = lis.length;
for (; i < len; ++i) {
props = lis[i];
props.detachAll();
remove(props.el, props.type, props.fn, props.capture);
delete _wrappers[props.key];
delete _el_events[props.domkey][props.key];
}
}
},
/**
* Returns all listeners attached to the given element via addListener.
* Optionally, you can specify a specific type of event to return.
* @method getListeners
* @param el {HTMLElement|string} the element or element id to inspect
* @param type {string} optional type of listener to return. If
* left out, all listeners will be returned
* @return {Y.Custom.Event} the custom event wrapper for the DOM event(s)
* @static
*/
getListeners: function(el, type) {
var ek = Y.stamp(el, true), evts = _el_events[ek],
results=[] , key = (type) ? 'event:' + ek + type : null;
if (!evts) {
return null;
}
if (key) {
if (evts[key]) {
results.push(evts[key]);
}
// get native events as well
key += 'native';
if (evts[key]) {
results.push(evts[key]);
}
} else {
Y.each(evts, function(v, k) {
results.push(v);
});
}
return (results.length) ? results : null;
},
/**
* Removes all listeners registered by pe.event. Called
* automatically during the unload event.
* @method _unload
* @static
* @private
*/
_unload: function(e) {
Y.each(_wrappers, function(v, k) {
v.detachAll();
remove(v.el, v.type, v.fn, v.capture);
delete _wrappers[k];
delete _el_events[v.domkey][k];
});
},
/**
* Adds a DOM event directly without the caching, cleanup, context adj, etc
*
* @method nativeAdd
* @param {HTMLElement} el the element to bind the handler to
* @param {string} type the type of event handler
* @param {function} fn the callback to invoke
* @param {boolen} capture capture or bubble phase
* @static
* @private
*/
nativeAdd: add,
/**
* Basic remove listener
*
* @method nativeRemove
* @param {HTMLElement} el the element to bind the handler to
* @param {string} type the type of event handler
* @param {function} fn the callback to invoke
* @param {boolen} capture capture or bubble phase
* @static
* @private
*/
nativeRemove: remove
};
}();
Y.Event = Event;
if (Y.config.injected || YUI.Env.windowLoaded) {
onLoad();
} else {
add(window, "load", onLoad);
}
// Process onAvailable/onContentReady items when when the DOM is ready in IE
if (Y.UA.ie) {
Y.on(EVENT_READY, Event._poll, Event, true);
}
Y.on("unload", onUnload);
Event.Custom = Y.CustomEvent;
Event.Subscriber = Y.Subscriber;
Event.Target = Y.EventTarget;
Event.Handle = Y.EventHandle;
Event.Facade = Y.EventFacade;
Event._poll();
})();
/**
* DOM event listener abstraction layer
* @module event
* @submodule event-base
*/
/**
* Executes the callback as soon as the specified element
* is detected in the DOM.
* @event available
* @param type {string} 'available'
* @param fn {function} the callback function to execute.
* @param el {string|HTMLElement|collection} the element(s) to attach
* @param context optional argument that specifies what 'this' refers to.
* @param args* 0..n additional arguments to pass on to the callback function.
* These arguments will be added after the event object.
* @return {EventHandle} the detach handle
* @for YUI
*/
Y.Env.evt.plugins.available = {
on: function(type, fn, id, o) {
var a = arguments.length > 4 ? Y.Array(arguments, 4, true) : [];
return Y.Event.onAvailable.call(Y.Event, id, fn, o, a);
}
};
/**
* Executes the callback as soon as the specified element
* is detected in the DOM with a nextSibling property
* (indicating that the element's children are available)
* @event contentready
* @param type {string} 'contentready'
* @param fn {function} the callback function to execute.
* @param el {string|HTMLElement|collection} the element(s) to attach
* @param context optional argument that specifies what 'this' refers to.
* @param args* 0..n additional arguments to pass on to the callback function.
* These arguments will be added after the event object.
* @return {EventHandle} the detach handle
* @for YUI
*/
Y.Env.evt.plugins.contentready = {
on: function(type, fn, id, o) {
var a = arguments.length > 4 ? Y.Array(arguments, 4, true) : [];
return Y.Event.onContentReady.call(Y.Event, id, fn, o, a);
}
};
}, '@VERSION@' ,{requires:['event-custom-base']});