Skip to content

dimooze/jquery-simulate-ext

 
 

Repository files navigation

jQuery Simulate Extended Plugin 1.1.4

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.

Table of Contents

Usage

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"
  • From the simulate-ext plugins:
    • Drag & Drop: "drag-n-drop", "drag", "drop"
    • "key-sequence"
    • "key-combo"

Example:

$('input[name="testInput"]').simulate("key-sequence", {sequence: "asdf"});

Demos:

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:

Documentation

The options and events for the different interactions are described in the files in the doc folder:

Requirements

The plugin requires

Compatibility

The plugins have been successfully tested with jQuery 1.7.2 and jQuery Simulate @485ca7192a. However, they should be compatible with future versions.

Licensing

Copyright © 2012 Jochen Ulrich https://github.com/j-ulrich/jquery-simulate-ext

Licensed under the MIT license.