{"_id":"propagating-hammerjs","maintainers":[{"name":"josdejong","email":"wjosdejong@gmail.com"}],"keywords":["hammerjs","touch","gestures","event","propagation"],"dist-tags":{"latest":"3.0.0"},"author":{"name":"Jos de Jong"},"description":"Extend hammer.js with event propagation","readme":"# propagating-hammerjs\n\nExtend [hammer.js](https://hammerjs.github.io/) (v2) with event propagation.\n\nWe use the [@egjs/hammerjs](https://www.npmjs.com/package/@egjs/hammerjs) fork because [hammer.js](https://www.npmjs.com/package/hammerjs) is [not maintained anymore](https://github.com/hammerjs/hammer.js/graphs/code-frequency).\n\n## Features\n\n- Events emitted by hammer will propagate in order from child to parent\n elements.\n- Events are extended with a function `event.stopPropagation()` to stop\n propagation to parent elements.\n- Events are extended with a property `event.firstTarget` containing the\n element where a gesture started.\n- Supports changing and rearranging the HTML DOM on the fly.\n- Load via commonjs, AMD, or as a plain old JavaScript file.\n\n## Install\n\n```sh\nnpm install @egjs/hammerjs propagating-hammerjs\n```\n\n## Load\n\n### Browser\n\n```html\n\n\n\n \n \n \n\n\n\n\n```\n\n### Commonjs (e.g. Node.js, Browserify)\n\n```js\nvar Hammer = require('@egjs/hammerjs');\nvar propagating = require('propagating-hammerjs');\n\nfunction init() {\n var hammer = propagating(new Hammer(element));\n}\n```\n\n### ESM (e.g. ES6, typescript)\n\n```typescript\nimport Hammer from '@egjs/hammerjs';\nimport propagating from 'propagating-hammerjs';\n\nfunction init() {\n const hammer = propagating(new Hammer(element));\n}\n```\n\n## Use\n\nTo extend individual hammer.js instances with event propagation:\n\n```js\nvar hammer = propagating(new Hammer(element));\n```\n\nTo extend the global hammer.js constructor\n\n```js\nHammer = propagating(Hammer);\n```\n\n## Examples\n\nHere a basic usage example.\nMore examples are available in the folder [/examples](./examples/).\n\n```html\n\n\n\n \n \n \n\n\n\n\n parent\n
\n child\n
\n