Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
demo Cleaned out unnecessary code / files (ei: ads) Aug 13, 2013
lib Cleaned out unnecessary code / files (ei: ads) Aug 13, 2013
.gitignore Lots of cleanup Jul 3, 2013
index.html Cleaned out unnecessary code / files (ei: ads) Aug 13, 2013
mousestop.jquery.json Updated links Jul 16, 2013
package.json Updated links Jul 16, 2013


A jQuery mousestop plugin to compliment other mouse events such as mousemove, mouseout and mouseout coming in at ~1Kb minified.

The mousestop event was created using the jQuery Special Events API and therefore can be binded like any other event.


The most basic usage is to pass in the callback for a stop event.

$('#el').mousestop(function() {

We can also pass the delay time in the second parameter to specify the amount of time to delay before a stop triggers. The default is 300 milliseconds

$('#el').mousestop(2000, function() {

There is also a settings parameter called timeToStop. This parameter specifies a window of time that the stop event has to occur. After that time the stop event will no longer trigger whatsoever. Leaving the value unset or setting it to null will deactivate this timer.

$('#el').mousestop({timeToStop: 1000}, function() {

To set both a delay and a settings parameter.

$('#el').mousestop({delay: 400, timeToStop: 1000}, function() {

We can also bind and trigger the event as you would expect with any other element.

$('#el').bind('mousestop', function(){


Since we are using the jQuery special API we can also use the on method to bind the event as well.

$('#el').on('mousestop', function(){


If you want to use Grunt you will need to install the required plugins locally using npm install in the root folder of the project. If you need to setup Grunt on your system you can follow this Setting up Grunt.js guide.



MIT licensed

Copyright (C) 2011-2012 Websanova