Get new jQuery plugins just once a week

×

Idlecat

FavoriteLoadingAdd to favorites

May 5, 2016

Idlecat | Lightweight jQuery plugin for user-presence detection.

Idlecat is a simple and lightweight jQuery plugin for user-presence detection.

Created by Přemysl Karbula

Download

jquery-idlecat

idleCat

Simple and lightweight jQuery plugin for user-presence detection.

Why?

Have you ever needed to perform a single or periodic task on your page based on user's actual presence? Do you think you really need to fetch new notifications from your servers all the time, or isn't such task quite pointless unless there actually is an active user sitting in front of your page?

How do you detect user's presence? The answer is: idleCat.

Installation

As this is a jQuery plugin, you need jQuery (idleCat was tested on jQuery 1.12.2), but other than that all you really need is to include the minified script located at build/jquery.idleCat.js to your HTML.

...
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.2/jquery.min.js"></script>
<script src="./js/jquery.idleCat.min.js"></script>
...

Usage

// Create an instance of idleCat on a jQuery object.
var instance = $('#status').idleCat({

    // Number of seconds to wait between two scans of user activity.
    interval: 2,

    // How many seconds to hold the activity from the moment of knowing there was not any activity.
    release: 2,

    // The default state of the idleness (use 'active' or 'idle').
    state: 'idle',

    // Callback fired after the discovery of user activity on the page.
    activeCallback: function() {
        $(this).addClass('active');
    },

    // Callback fired after the discovery of used idleness on the page.
    // (+ number of seconds defined in the 'release' property)
    idleCallback: function(element) {
        $(this).removeClass('active');
    },

    // See below for more options...

});

// Log current state from idleCat attached to that jQuery object.
window.setInterval(function() {
    console.log(instance.getState());
}, 1000)

Options

idleCat is configured using a config object passed into the plugin's initializer:

$('#status').idleCat({ ... });

Available options:

interval
release
state
fireOnInit
activeCallback
idleCallback

Keywords

javascript, jquery, idle time, user presence, user activity, user inactivity, user idle, inactivity, indication

Idlecat

Related posts:

jsPDF
Leroy Zoom
PhotoJshop

To install using Bower
bower install jquery-idlecat

jquery-idlecat

http://jquer.in/wp-content/uploads/2016/04/jquery-idlecat.jpg

jQuery plugin

Sign up for our weekly newsletter.

* We won't spam you ever