hammer.js

A JavaScript library for detecting touch gestures.

What is this repository?

It seems like that hammer.js repository is no more activated.

• Is this library still actively maintained?

But our library (egjs) has deep dependency to hammer.js for touch interaction. And some pending issues were critical for us to make more light size, compatible with node.js , resolve module crash on umd envrioment.

So we solved following issues that are not resolved in original hammer.js

• Support for hammer.js in node.js
  • Make hammerjs server friendly
  • Hammer.js fails in node since window is undefined
• Support ES Module for Tree Shaking
• Change the priority of define and exports for umd
• Polymer/shadow-dom compatibility

We would maintain this repository to fix remain bugs and enhance it until original repository activates.

Installation

NPM

1npm install --save @egjs/hammerjs

or

Yarn

1yarn add @egjs/hammerjs

or

CDN

https://cdnjs.com/libraries/hammer.js/

We did not provide CDN yet. leave the link to original hammerjs as is.

Usage

hammer.js has a quick start option for gestures it already recognizes.

1// Get a reference to an element.
2var square = document.querySelector('.square');
3
4// Create an instance of Hammer with the reference.
5var hammer = new Hammer(square);
6
7// Subscribe to a quick start event: press, tap, or doubletap.
8// For a full list of quick start events, read the documentation.
9hammer.on('press', function(e) {
10  e.target.classList.toggle('expand');
11  console.log("You're pressing me!");
12  console.log(e);
13});

If you want to recognize your own gestures, such as tripletap, then you'll have to use these steps:

1// Get a reference to an element.
2var square = document.querySelector('.square');
3
4// Create a manager to manage the element.
5var manager = new Hammer.Manager(square);
6
7// Create a recognizer.
8var TripleTap = new Hammer.Tap({
9  event: 'tripletap',
10  taps: 3
11});
12
13// Add the recognizer to the manager.
14manager.add(TripleTap);
15
16// Subscribe to the event.
17manager.on('tripletap', function(e) {
18  e.target.classList.toggle('expand');
19  console.log("You're triple tapping me!");
20  console.log(e);
21});

Examples

• tap
• double tap
• press
• swipe

Documentation

For further information regarding hammer.js, please read our documentation.

Contributions

Feel encouraged to report issues or submit pull requests. When you're ready to do either, read our contribution guidelines. If you're looking for another form of contribution, we love help answering questions on our slack channel.

License

MIT