propagating-hammerjs
====================
Extend hammer.js v2 with event propagation.
# Features
- Events emitted by hammer will propagate in order from child to parent
elements.
- Events are extended with a function `event.stopPropagation()` to stop
propagation to parent elements.
- Events are extended with a property `event.firstTarget` containing the
element where a gesture started.
- Supports changing and rearranging the HTML DOM on the fly.
- Load via commonjs, AMD, or as a plain old JavaScript file.
# Install
npm install propagating-hammerjs
# Load
## Browser
```html
```
## Commonjs (Node.js + Browserify)
```js
var Hammer = require('hammerjs');
var propagating = require('propagating-hammerjs');
function init() {
var hammer = propagating(new Hammer(element));
}
```
# Use
To extend individual hammer.js instances with event propagation:
```js
var hammer = propagating(new Hammer(element));
```
To extend the global hammer.js constructor
```js
Hammer = propagating(Hammer);
```
# Examples
Here a basic usage example.
More examples are available in the folder [/examples](./examples/).
```html
```
# API
Construction:
propagating(hammer: Hammer.Manager [, options: Object]) : Hammer.Manager
**parameters**
- `hammer: Hammer.Manager` An hammer instance or the global hammer constructor.
- `options: Object` An optional object with options. Available options:
- `preventDefault: true | 'mouse' | 'touch' | 'pen'`. Optional.
Enforce preventing the default browser behavior. Cannot be set to `false`.
**returns**
Returns the same hammer instance with extended functionality.
**events**
The emitted [hammer.js events](http://hammerjs.github.io/api/#event-object) are
extended with:
- `event.stopPropagation()`
If called, the event will not further propagate the elements parents.
- `event.firstTarget`
Contains the HTML element where a gesture started (where as `event.target`
contains the element where the pointer is right now).
# License
MIT