The simulate extended plugin provides methods for simulating complex user interactions based on the jQuery.simulate.js plugin from jQuery UI. The plugin provides simulation of:
- Drag & Drop
- Key Sequences
- Key Combinations
Additionally, the extended plugin includes documentation and fixes for the jQuery simulate plugin itself.
To use the jQuery simulate extended plugins, include jquery.simulate.js
, jquery.simulate.ext.js
and then the desired plugins (in that order).
The simulations are executed by calling the .simulate()
function on a jQuery object. The simulation
is then executed on all elements in the collection of the jQuery object (unless otherwise noted).
- Synopsis:
.simulate(type, options)
- Parameters:
- type {String}: The type of the interaction to be simulated.
- options {Object}: An option object containing the options for the action to be simulated.
The types of simulated actions are:
- From the simulate plugin:
- Mouse Events:
"mousemove"
,"mousedown"
,"mouseup"
,"click"
,dblclick"
,"mouseover"
,"mouseout"
,"mouseenter"
,"mouseleave"
,"contextmenu"
- Key Events:
"keydown"
,"keyup"
,"keypress"
"focus"
"blur"
- Mouse Events:
- From the simulate-ext plugins:
- Drag & Drop:
"drag-n-drop"
,"drag"
,"drop"
"key-sequence"
"key-combo"
- Drag & Drop:
$('input[name="testInput"]').simulate("key-sequence", {sequence: "asdf"});
The demos folder contains a demonstration of most of the features of the simulate extended plugins.
Live demos can be found at jsFiddle and JS Bin where you can also play around with the plugin:
- http://jsfiddle.net/Ignitor/Psjhf/embedded/result/ (jsFiddle)
- http://jsbin.com/inalax/25/edit#live (JS Bin)
The options and events for the different interactions are described in the files in the doc folder:
The plugin requires
- jQuery 1.7.0+
- jQuery Simulate
- bililiteRange for the key-sequence and key-combo plugins
The plugins have been successfully tested with jQuery 1.7.2 and jQuery Simulate @485ca7192a. However, they should be compatible with future versions.
Copyright © 2012 Jochen Ulrich https://github.com/j-ulrich/jquery-simulate-ext
Licensed under the MIT license.