hammer.js README

The project's README from github.com/hammerjs/hammer.js. As one markdown file: README.md.

hammer.js NPM Version NPM Downloads Build Status

A JavaScript library for detecting touch gestures.

Installation

NPM

npm install --save hammerjs

or

Yarn

yarn add hammerjs

or

CDN

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

Usage

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

// 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:

// 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

Documentation

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

Contributions Github Issues Github PRs Slack

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

hammer.js (hammerjs/hammer.js)

Searching Database…

24.3K ·GitHub
Hammer.js
Что это такое?Hammer.js — это JavaScript-библиотека, которая позволяет веб-странице распознавать жесты на сенсорном экране, так что вам не приходится самому разбирать низкоуровневые события касаний.
Это приложение, которое я устанавливаю на телефон, или то, что добавляется на сайт?Это фронтенд-библиотека на JavaScript: вы подключаете её к веб-странице, и она работает везде, где работает эта страница — в браузерах на компьютере и на сенсорных устройствах вроде телефонов и планшетов.
Как добавить её в свой проект?Установите её через npm или yarn либо просто подключите со CDN на своей странице.
Не раздует ли она мой проект лишними зависимостями?Нет — в пакете нет ни одной рантайм-зависимости, так что в ваш бандл ничего лишнего не попадёт.
А если мне нужен жест, которого нет в библиотеке, например тройное касание (tripletap)?Это потребует дополнительной работы: для такого жеста, как tripletap, в README сказано, что придётся самостоятельно настроить распознавание по её инструкции — из коробки этого нет.
Можно ли использовать её в коммерческих проектах, и сколько это стоит?Библиотека распространяется по лицензии MIT, поэтому её можно бесплатно использовать, изменять и распространять — в том числе в коммерческих целях.
Есть ли готовый минифицированный файл, который можно отдавать в продакшене?Да — при сборке репозитория создаётся файл hammer.min.js вместе с source map, так что минифицированную версию можно подключать напрямую.
What are similar projects?dragula, Sortable, better-scroll, swiper, interact.js, velocity, masonry, typeahead.js
Which topics is it in?interaction, hybrid, scripts, yarn, map, cdn, touch, dom, javascript-library, browser, mobile, ui
Creator
hammerjs
Size
9.9 MB
Stars
24.3K
Updated
CommitMay 28
Age
14y
Commits · 90 Days