event-touch.js revision dcde9f9fdb7cdb40d391c49e82df809afef42c01
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen DesaiYUI.add('event-touch', function(Y) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai/**
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * Adds touch event facade normalization properties (touches, changedTouches, targetTouches etc.) to the DOM event facade
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai *
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @module event-touch
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai */
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desaivar SCALE = "scale",
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai ROTATION = "rotation",
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai IDENTIFIER = "identifier";
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai/**
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * Adds touch event facade normalization properties to the DOM event facade
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai *
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @method _touch
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @for DOMEventFacade
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @private
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @param ev {Event} the DOM event
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @param currentTarget {HTMLElement} the element the listener was attached to
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @param wrapper {Event.Custom} the custom event wrapper for this DOM event
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai */
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen DesaiY.DOMEventFacade.prototype._touch = function(e, currentTarget, wrapper) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai var i,l, etCached, et,touchCache;
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai if (e.touches) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai /**
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * Array of individual touch events for touch points that are still in
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * contact with the touch surface.
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai *
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @property touches
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @type {DOMEventFacade[]}
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai */
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai this.touches = [];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai touchCache = {};
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai for (i = 0, l = e.touches.length; i < l; ++i) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai et = e.touches[i];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai touchCache[Y.stamp(et)] = this.touches[i] = new Y.DOMEventFacade(et, currentTarget, wrapper);
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai }
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai }
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai if (e.targetTouches) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai /**
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * Array of individual touch events still in contact with the touch
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * surface and whose `touchstart` event occurred inside the same taregt
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * element as the current target element.
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai *
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @property targetTouches
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai * @type {DOMEventFacade[]}
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai */
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai this.targetTouches = [];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai for (i = 0, l = e.targetTouches.length; i < l; ++i) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai et = e.targetTouches[i];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai etCached = touchCache && touchCache[Y.stamp(et, true)];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai this.targetTouches[i] = etCached || new Y.DOMEventFacade(et, currentTarget, wrapper);
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai }
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai }
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai if (e.changedTouches) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
829545a6bc03a4ec90be779dfdba3815f6454311Satyen Desai /**
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai An array of event-specific touch events.
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai For `touchstart`, the touch points that became active with the current
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai event.
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
829545a6bc03a4ec90be779dfdba3815f6454311Satyen Desai For `touchmove`, the touch points that have changed since the last
829545a6bc03a4ec90be779dfdba3815f6454311Satyen Desai event.
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai For `touchend`, the touch points that have been removed from the touch
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai surface.
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai @property changedTouches
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai @type {DOMEventFacade[]}
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai **/
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai this.changedTouches = [];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai for (i = 0, l = e.changedTouches.length; i < l; ++i) {
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai et = e.changedTouches[i];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai etCached = touchCache && touchCache[Y.stamp(et, true)];
02116a8536c9212761e6bf4c29521c9e8af4988eSatyen Desai
this.changedTouches[i] = etCached || new Y.DOMEventFacade(et, currentTarget, wrapper);
}
}
if (SCALE in e) {
this[SCALE] = e[SCALE];
}
if (ROTATION in e) {
this[ROTATION] = e[ROTATION];
}
if (IDENTIFIER in e) {
this[IDENTIFIER] = e[IDENTIFIER];
}
};
if (Y.Node.DOM_EVENTS) {
Y.mix(Y.Node.DOM_EVENTS, {
touchstart:1,
touchmove:1,
touchend:1,
touchcancel:1,
gesturestart:1,
gesturechange:1,
gestureend:1
});
}
}, '@VERSION@' ,{requires:['node-base']});