https://github.com/zewa666/jquery-touchhold

A simple jQuery plugin to allow event binding for tap-and-hold events on touch devices
https://github.com/zewa666/jquery-touchhold

Last synced: about 13 hours ago
JSON representation

A simple jQuery plugin to allow event binding for tap-and-hold events on touch devices

• Host: GitHub
• URL: https://github.com/zewa666/jquery-touchhold
• Owner: zewa666
• Created: 2013-01-18T22:06:53.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2013-01-19T08:54:28.000Z (almost 12 years ago)
• Last Synced: 2023-04-06T14:20:36.544Z (over 1 year ago)
• Language: JavaScript
• Homepage:
• Size: 101 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
jQuery Touchhold Plugin

=======================

jQuery Touchhold provides event bindings for 'tap-and-hold' or 'longtap' events on touch devices. 

Unlike other touch libraries with support for long tap events, jQuery TouchHold allows you to bind two different event handlers: 

* When the user finishes a long tap, a "touchhold.end" event is triggered

* While the user is still touching the screen, a preliminary "touchhold.start" event is triggered signifying that enough time has elapsed for the touch to be considered a long tap, and a second when the user finishes the tap. 

This allows you to provide more responsive visual feedback while the user is tapping on an element, as well as more accurately imitate native iOS behavior for object selection (e.g. copy/paste).

jQuery is currently a prerequisite. I haven't tested with Zepto.js, but it's possible it might work.

Usage

-----

To bind an event that fires after a user completes a long tap, you can just write:

```js

	$("#selector").touchhold(function() {});

```

You can essentially treat .touchhold() like any of the default jQuery event binding helpers (.click(), .doubleclick(), etc).

If you want a function to be called when the current touch is long enough to be considered a long touch, just pass the function in as an optional second parameter:

```js

	var foo = function() { console.log("You completed a long tap."); }, 

		bar = function() { console.log("You held down your finger long enough.")};

		

	$("#selector").touchhold(foo, bar);

```

If you only want to bind a function to fire on the timeout, you can pass in your favorite falsy value as the first parameter; as long as it's not a function, it won't get called. 

To Do

-----

* 'touchhold.start' and 'touchhold.end' events can't be bound via .bind or .delegate without having called .touchhold() first on that element.

* Eliminate jQuery dependency