$('div.target').userAction("click", x, y); UserAction Plugin - Simulate mouse/keys real events.

This commit is contained in:
Eduardo Lundgren 2008-05-26 21:18:03 +00:00
parent 76525dc99d
commit a68d347da2

View File

@ -0,0 +1,211 @@
/* Copyright (c) 2007 Eduardo Lundgren (eduardolundgren@gmail.com)
* Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php)
* and GPL (http://www.opensource.org/licenses/gpl-license.php) licenses.
*
* Version: 0.1a
* Requires jQuery 1.2.x+
* Docs: http://docs.jquery.com/Plugins/userAction
*/
;(function($) {
$.fn.extend({
userAction: function(type) {
var args = arguments, opts = {}, a1 = args[1], a2 = args[2];
// transfer center offset
if (a1 && a1.length) {
opts.center = [a1[0], a1[1]];
}
// set x and y
else if (typeof a1 == StringPool.NUMBER) {
opts.x = a1; options.y = a2;
}
// extend options
else {
$.extend(opts, a1);
}
return this.each(function() {
new $.userAction(this, type, opts);
});
}
});
$.userAction = function(el, type, options) {
this.type = type;
this.options = $.extend({}, $.userAction.defaults, options || {});
this.target = $(this.options.target || el)[0];
var self = this, o = this.options, c = o.center, xy = this.findCenter(
c && c.length ? c : [0, 0]
);
// if x and y not set, get the center of the element
o.x = o.x || xy.x; o.y = o.y || xy.y;
var EVENT_DEFAULT = {
view: window,
detail: 0,
isTrusted: false,
bubbles: o.bubbles || true,
cancelable: o.cancelable || false,
ctrlKey: o.ctrlKey || false,
altKey: o.altKey || false,
shiftKey: o.shiftKey || false,
metaKey: o.metaKey || false
},
isMouse = /^mouse(over|out|down|up|move)|(dbl)?click$/i.test(type),
isKeyboard = /^textevent|key(up|down|press)$/i.test(type);
var EVT = isMouse ?
$.extend({}, EVENT_DEFAULT, {
clientX: o.x, clientY: o.y,
screenX: o.screenX || 0, screenY: o.screenY || 0,
relatedTarget: $(o.relatedTarget)[0] || null,
button: o.button || ($.browser.msie ? 1 : 0)
}) :
$.extend({}, EVENT_DEFAULT, {
keyCode: o.keyCode || 0, charCode: o.charCode || 0
});
if (o.before) o.before.apply(this.target, [
// simulate correct target before the event fire
// the browser just set the correct EVT.target after dispatchment
$.event.fix(EVT).target = this.target, o.x, o.y, this]);
// check event type for mouse events
if (isMouse) {
// simulating mouse event
EVT = this.mouseEvent(EVT)
}
// check event type for key events
if (isKeyboard) {
// simulating keuboard event
EVT = this.keyboardEvent(EVT);
}
if (o.after) o.after.apply(this.target, [EVT, o.x, o.y, this]);
};
$.extend($.userAction.prototype, {
mouseEvent: function(EVT) {
var evt, type = this.type, o = this.options;
//check for DOM-compliant browsers
if ($.isFunction(document.createEvent)) {
evt = document.createEvent(StringPool.MOUSE_EVENTS);
//Safari 2.x doesn't implement initMouseEvent()
if ($.isFunction(evt.initMouseEvent)) {
evt.initMouseEvent(type,
EVT.bubbles, EVT.cancelable, EVT.view, EVT.detail,
EVT.screenX, EVT.screenY, EVT.clientX, EVT.clientY,
EVT.ctrlKey, EVT.altKey, EVT.shiftKey, EVT.metaKey,
EVT.button, EVT.relatedTarget);
} else {
// Safari
evt = document.createEvent(StringPool.UI_EVENTS);
customEvent.initEvent(type, EVT.bubbles, EVT.cancelable);
$.extend(evt, EVT);
}
// check to see if relatedTarget has been assigned
if (EVT.relatedTarget && !evt.relatedTarget){
if (type == StringPool.MOUSEOUT) {
evt.toElement = EVT.relatedTarget;
} else if (type == StringPool.MOUSEOVER) {
evt.fromElement = EVT.relatedTarget;
}
}
// fire the event
this.target.dispatchEvent(evt);
} else if (document.createEventObject) {
evt = document.createEventObject();
$.extend(evt, EVT)
// IE won't allow assignment to toElement or fromElement
evt.relatedTarget = EVT.relatedTarget;
// fire the event
this.target.fireEvent(StringPool.ON + type, evt);
}
return evt;
},
keyboardEvent: function(EVT) {
var evt, type = this.type, o = this.options;
//Safari 2.x doesn't implement initMouseEvent()
if ($.isFunction(document.createEvent)) {
try {
// try to create key event
evt = document.createEvent("KeyEvents");
evt.initKeyEvent(type,
EVT.bubbles, EVT.cancelable, EVT.view, EVT.ctrlKey,
EVT.altKey, EVT.shiftKey, EVT.metaKey, EVT.keyCode, EVT.charCode);
} catch (err) {
// we need another try-catch for Safari 2.x
try {
// generic event, will fail in Safari 2.x
evt = document.createEvent("Events");
} catch (uierror){
// create a UIEvent for Safari 2.x
evt = document.createEvent("UIEvents");
} finally {
evt.initEvent(type, EVT.bubbles, EVT.cancelable);
// initialize
$.extend(evt, EVT);
}
}
// fire the event
this.target.dispatchEvent(evt);
} else if (document.createEventObject) {
// create an IE event object
evt = document.createEventObject();
// assign available properties
$.extend(evt, EVT);
// IE doesn't support charCode explicitly
evt.keyCode = (EVT.charCode > 0) ? EVT.charCode : EVT.keyCode;
// fire the event
this.target.fireEvent("on" + type, evt);
}
return evt;
},
findCenter: function(offset) {
var el = $(this.target), o = el.offset();
return {
x: o.left + (((offset||[0, 0])[0]) || 0) + el.width() / 2,
y: o.top + (((offset||[0, 0])[1]) || 0) + el.height() / 2
};
}
});
$.extend($.userAction, {
defaults: {
center: true
}
});
var StringPool = {
ON: 'on',
NUMBER: 'number',
MOUSEOVER: 'mouseover',
MOUSEOUT: 'mouseout',
MOUSE_EVENTS: "MouseEvents",
UIU_EVENTS: "UIEvents"
};
})(jQuery);