Skip to content

A custom 'tap' event JavaScript plugin for touch devices

License

Notifications You must be signed in to change notification settings

defconcepts/tap.js

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tap.js

A custom 'tap' event JavaScript plugin for mobile and tablet web browsers, which eliminates the 300ms delay between a physical 'tap' and the firing of a 'click' event. Uses mouse events as a fallback for browsers that don't support touch.

Installation

  • Download: zip
  • NPM: npm install tap.js
  • Bower: bower install tap.js
  • Git: git clone https://github.com/alexgibson/tap.js

Setup

This component can be used as an AMD module, CommonJS module, or a global.

for AMD module:

define(['./tap'], function(Tap) {
    // ...
});

for CommonJS:

var Tap = require('tap.js');

for global in the browser

<script src="tap.js"></script>

Next create a new Tap instance, passing the element you want to use:

var el = document.getElementById('my-id'),
	myTap = new Tap(el);

You can then start listening for 'tap' events using the regular JavaScript event listener syntax:

el.addEventListener('tap', onTap, false);

function onTap (e) {
	//your code
}

You can stop listening for tap events like so:

el.removeEventListener('tap', onTap, false);

When a Tap instance is created, it adds a couple of event listeners on its element. To remove those listeners and cleanup the Tap instance completely, use its destroy() function:

var myTap = new Tap(el);
myTap.destroy();

Supported web browsers

  • iOS (Safari, Chrome)
  • Android (Browser, Chrome)
  • Firefox OS, Firefox for Android
  • Opera Mobile (Android)
  • All modern desktop browsers (mouse fallback)

jQuery Support

Should you wish to use tap.js with jQuery, there is an optional jQuery wrapper that you can include in your project.

About

A custom 'tap' event JavaScript plugin for touch devices

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 81.6%
  • HTML 18.4%