Cross browser and device event handler with delegation, chaining and filtering engines
Sewer will help you dealing with all the crap needed to handle dom events.
Sewer is cross browser and provides some cool features such as:
- cross browser target element
- automatic touch mapping
$ component install bredele/sewer
$ npm install sewer
var ev = require'sewer';evbinddocumentbody 'click'// do something;
See API for more details.
Delegate events with query selection. In the example above, the callback
is executed only when a
button with the className
evbinddocumentbody 'click button.clickable'//do something only when buttons with the//class clickable are clicked;
Touch events are automatically mapped with desktop/mouse events. It is great because your implementation doesn't depend on the device and at the end you'll have one code that works everywhere.
evbindel 'click'// do something on touch end;
In this example the callback is executed on
touchend if you are on a mobile device
click => touchendmouseup => touchendmousedown => touchstartmousemove => touchmove
A code which depends on the event is hard to reuse or maintain. A good practice is to dissociate the event manipulation from the real logic:
evbindel 'click' fn1 fn2;epreventDefault;return targetinnerHTML;//do something on target innerHTML
Filter events with key code. In the example above, the callback is executed
enter is pressed.
var input = documentquerySelector'input';evbindinput 'keypress > 13'//do something only on enter;
Add an event listener (alias
evbinddocumentbody 'click'//do something;
The first argument of the callback is the element (cross browser target) that trigerred the event.
bind returns an array (topic, callback, capture) in case you want to remove the listener.
Remove an event listener (alias
The MIT License (MIT)
Copyright (c) 2014 Olivier Wietrich email@example.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.