https://github.com/hammerjs/hammer.js
A javascript library for multi-touch gestures :// You can touch this
https://github.com/hammerjs/hammer.js
Last synced: 7 months ago
JSON representation
A javascript library for multi-touch gestures :// You can touch this
- Host: GitHub
- URL: https://github.com/hammerjs/hammer.js
- Owner: hammerjs
- License: mit
- Created: 2012-03-02T12:58:28.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2023-02-15T09:48:48.000Z (almost 3 years ago)
- Last Synced: 2025-05-05T16:06:49.840Z (7 months ago)
- Language: JavaScript
- Homepage: http://hammerjs.github.io
- Size: 9.75 MB
- Stars: 24,282
- Watchers: 527
- Forks: 2,617
- Open Issues: 320
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-javascript - hammer.js - A JavaScript library for multi-touch gestures. (Gesture / Other)
- my-awesome - hammer.js - A javascript library for multi-touch gestures :// You can touch this (JavaScript)
- awesome-javascript - hammer.js - A javascript library for multi-touch gestures :// You can touch this - ★ 19243 (Gesture)
- fucking-awesome-javascript - hammer.js - A JavaScript library for multi-touch gestures. (Gesture / Other)
- awesome-focusnetworks - hammer.js - A javascript library for multi-touch gestures. [](http://spmjs.io/package/hammerjs) (Gesture / Other)
- awesome-js - hammer.js - A javascript library for multi-touch gestures (Framework or Library / Just Awesome)
- awesome-inspiration - hammer.js
- awesome-javascript - hammer.js - A javascript library for multi-touch gestures :// You can touch this ` 📝 2 years ago ` (Gesture [🔝](#readme))
- awesome-javascript-cn - 官网
- awesome-frontend - Hammer.js
- awesome - hammerjs/hammer.js - A javascript library for multi-touch gestures :// You can touch this (JavaScript)
- awesome_frontend_development_resources - hammer.js - A javascript library for multi-touch gestures. (Touch Screen / React Components)
- my-awesome-list - hammer.js - A javascript library for multi-touch gestures (Programming Languages / JavaScript)
- awesome-star-libs - hammerjs / hammer.js
- awesome-frontend-libraries - hammerjs
- awesome - hammer.js - A javascript library for multi-touch gestures. (Touch Screen / React Components)
- A-collection-of-awesome-browser-side-JavaScript-libraries-resources-and-shiny-things. - hammer.js - A JavaScript library for multi-touch gestures. (Gesture / Other)
- annals-of-awesome - Resrouce - Touch support with no dependencies (Web Development / General)
- awesome-javascript-cn - hammer.js
- awesome-bookmarks - **hammer**
- awesome-javascript - Hammer.js - A javascript library for multi-touch gestures. (UI Interaction Libraries)
- awesome-frontend - Hammer.js
- awesome-front-end - Hammer.js
- awesome-github-star - hammer.js - touch gestures :// You can touch this | hammerjs | 23687 | (JavaScript)
README
# [hammer.js][hammerjs-url] [![NPM Version][npm-image]][npm-url] [![NPM Downloads][downloads-image]][downloads-url] [![Build Status][travis-image]][travis-url]
> A JavaScript library for detecting touch gestures.
## Installation
### NPM
```sh
npm install --save hammerjs
```
**or**
### Yarn
```sh
yarn add hammerjs
```
**or**
### CDN
[https://cdnjs.com/libraries/hammer.js/](https://cdnjs.com/libraries/hammer.js/)
## Usage
hammer.js has a quick start option for gestures it already recognizes.
```js
// Get a reference to an element.
var square = document.querySelector('.square');
// Create an instance of Hammer with the reference.
var hammer = new Hammer(square);
// Subscribe to a quick start event: press, tap, or doubletap.
// For a full list of quick start events, read the documentation.
hammer.on('press', function(e) {
e.target.classList.toggle('expand');
console.log("You're pressing me!");
console.log(e);
});
```
If you want to recognize your own gestures, such as `tripletap`, then you'll have to use these steps:
```js
// Get a reference to an element.
var square = document.querySelector('.square');
// Create a manager to manage the element.
var manager = new Hammer.Manager(square);
// Create a recognizer.
var TripleTap = new Hammer.Tap({
event: 'tripletap',
taps: 3
});
// Add the recognizer to the manager.
manager.add(TripleTap);
// Subscribe to the event.
manager.on('tripletap', function(e) {
e.target.classList.toggle('expand');
console.log("You're triple tapping me!");
console.log(e);
});
```
## Examples
- [tap][tap]
- [double tap][double-tap]
- [press][press]
- [swipe][swipe]
## Documentation
For further information regarding hammer.js, please read our [documentation][hammerjs-url].
## Contributions [![Github Issues][issues-image]][issues-url] [![Github PRs][pulls-image]][pulls-url] [![Slack][slack-image]][slack-url]
Feel encouraged to report issues or submit pull requests. When you're ready to do either, read our [contribution guidelines][contribution-guidelines]. If you're looking for another form of contribution, we love help answering questions on our [slack channel][slack-url].
## License
[MIT][license]
[hammerjs-url]: http://hammerjs.github.io
[npm-image]: https://img.shields.io/npm/v/hammerjs.svg
[npm-url]: https://npmjs.org/package/hammerjs
[travis-image]: https://img.shields.io/travis/stream-utils/raw-body/master.svg
[travis-url]: https://travis-ci.org/hammerjs/hammer.js
[downloads-image]: https://img.shields.io/npm/dm/hammerjs.svg
[downloads-url]: https://npmjs.org/package/hammerjs
[tap]: https://codepen.io/choskim/pen/WZggmg
[double-tap]: https://codepen.io/choskim/pen/vezzwZ
[press]: https://codepen.io/choskim/pen/RLYebL
[pan]: ''
[swipe]: https://codepen.io/choskim/pen/rGZqxa
[pinch]: ''
[rotate]: ''
[issues-image]: https://img.shields.io/github/issues/hammerjs/hammer.js.svg
[issues-url]: https://github.com/hammerjs/hammer.js/issues
[pulls-image]: https://img.shields.io/github/issues-pr/hammerjs/hammer.js.svg
[pulls-url]: https://github.com/hammerjs/hammer.js/pulls
[slack-image]: https://hammerjs.herokuapp.com/badge.svg
[slack-url]: https://hammerjs.herokuapp.com/
[contribution-guidelines]: ./CONTRIBUTING.md
[license]: ./LICENSE.md