[ { "path": "README.md", "content": "

jquery.event.swipe

\n\n

Dependencies

\n

jQuery.event.move: stephband.info/jquery.event.move

\n\n

One of swipeleft, swiperight, swipeup or swipedown is triggered on moveend, when the move has covered at least a threshold proportion of the dimension of the target node.

\n\n

Swipe events are a thin wrapper around the moveend event, a convenience to reveal when a finger has made a swipe gesture. As such they don't bubble — they are retriggered on each passing of a moveend event. The underlying move events do bubble and delegate. Use them if you need more flexibility.

\n\n\n

CommonJS

\n\n

If you're using Browserify, or any other CommonJS-compatible module system, you can require this script by passing it your jQuery reference. For example,

\n\n

\nrequire('./path/to/jquery.event.move.js')(jQuery);\n
\n\n

Demo and docs

\nstephband.info/jquery.event.swipe\n" }, { "path": "bower.json", "content": "{\n \"name\": \"jquery.event.swipe\",\n \"version\": \"0.5.3\",\n \"author\": {\n \"name\": \"Stephen Band\",\n \"url\": \"http://stephband.info\",\n \"twitter\": \"stephband\"\n },\n \"dependencies\": {\n \"jquery\": \">=1.7.0\",\n \"jquery.event.move\": \"1.x\"\n },\n \"licenses\": [{\"url\":\"http://www.wtfpl.net/txt/copying/\"}],\n \"main\": \"js/jquery.event.swipe.js\",\n \"description\": \"jQuery special events for the gestures swipeleft, swiperight, swipeup and swipedown.\",\n \"keywords\": [\"touch\",\"special\",\"event\",\"swipe\"],\n \"homepage\": \"http://github.com/stephband/jquery.event.swipe\",\n \"docs\": \"http://stephband.info/jquery.event.swipe\"\n}\n" }, { "path": "event.swipe.jquery.json", "content": "{\n \"name\": \"event.swipe\",\n \"title\": \"jquery.event.swipe\",\n \"version\": \"0.5.3\",\n \"author\": {\n \"name\": \"Stephen Band\",\n \"url\": \"http://stephband.info\"\n },\n \"dependencies\": {\n \"jquery\": \">=1.7.0\",\n \"jquery.event.move\": \"1.3.x\"\n },\n \"licenses\": [{\"url\":\"http://www.wtfpl.net/txt/copying/\"}],\n \"files\": [\"js/jquery.event.swipe.js\"],\n \"description\": \"jQuery special events for the gestures swipeleft, swiperight, swipeup and swipedown.\",\n \"keywords\": [\"touch\",\"special\",\"event\",\"swipe\"],\n \"homepage\": \"http://github.com/stephband/jquery.event.swipe\",\n \"docs\": \"http://stephband.info/jquery.event.swipe\"\n}\n" }, { "path": "index.html", "content": "---\ntitle: jQuery.event.swipe\n---\n\n\n\n\t\n\t\n\t\n\t\n\tjQuery.event.swipe\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\n\n\n\t
\n\t\t
\n\t\t\t\n\t\t\t\t

stephband.info

\n\t\t\t\n\t\t
\n\t
\n\n\t
\n\t\t

jQuery.event.swipe

\n\t\n\t\t
\n\t\t\t\n\t\t
\n\n\t\t\n\n\t\t

Project

\n\t\t\n\t\t\n\t\t

Swipe events

\n\t\t
\n\t\t\t
swipeleft, swiperight, swipeup, swipedown
\n\t\t\t
Fired when the finger is released from the touch surface (or mouse button) if the finger has a) just moved at least a threshold distance or b) moved quickly over a shorter distance.\n\t\t\t\t\tAlso responds to mouse events.
\n\t\t
\n\t\t

Swipe event objects are augmented with the properties:

\n\t\t
\n\t\t\t
e.pageX, e.pageY
\n\t\t\t
Current page coordinates of pointer.
\n\t\t\t\n\t\t\t
e.startX, e.startY
\n\t\t\t
Page coordinates the pointer had at the start of the swipe.
\n\t\t\t\n\t\t\t
e.distX, e.distY
\n\t\t\t
Distance finger moved during the swipe.
\n\t\n\t\t\t
e.velocityX, e.velocityY
\n\t\t\t
Velocity, in pixels/ms, averaged over the last few move events.
\n\t\t
\n\t\n\t\t

How to use swipe events

\n\t\n{% highlight js %}\nvar slides = jQuery('.slides'),\n i = 0;\n\nslides\n.on('swipeleft', function(e) {\n slides.eq(i + 1).addClass('active');\n})\n.on('swiperight', function(e) {\n slides.eq(i - 1).addClass('active');\n});{% endhighlight %}\n\t\n\t\t

\n\t\t\tSwipe events are a thin wrapper around the moveend event; a convenience to reveal when a finger has moved in a swipe gesture.\n\t\t\tThe underlying move events bubble and you can delegate them, but making the swipe events also do this would be unnecessarily expensive.\n\t\t\tUse move events if you need more flexibility.\n\t\t

\n\t\n\t\t

Swipe or scroll

\n\t\t

\n\t\t Swipe events are a thin wrapper built on top of move events (stephband.info/jquery.event.move).\n\t\t Move events, by default, override native scrolling, as they assume that you want to move something rather than scroll the window.\n\t\t To re-enable scrolling, call e.preventDefault() inside a movestart handler.\n\t\t

\n\t\t

\n\t\t In the example above, we want to be able to swipeleft and swiperight, but scroll up and down.\n\t\t Inside a movestart handler, the direction of the finger is moving is calculated and the event is prevented if it is found to be moving up or down::

\n\n{% highlight js %}\njQuery('.mydiv')\n.on('movestart', function(e) {\n // If the movestart is heading off in an upwards or downwards\n // direction, prevent it so that the browser scrolls normally.\n if ((e.distX > e.distY && e.distX < -e.distY) ||\n (e.distX < e.distY && e.distX > -e.distY)) {\n e.preventDefault();\n }\n});{% endhighlight %}\n\n\t\t

To see how the example at the top of the page works, view source.

\n\n\t\t

Who made it?

\n\t\t

I did. I'm stephband on twitter, if you're into that sort of thing.

\n\t
\n\n\t\n\n\t\n\t\n\t\n\t\n\n\n" }, { "path": "js/jquery.event.swipe.js", "content": "// jQuery.event.swipe\n// 0.5\n// Stephen Band\n\n// Dependencies\n// jQuery.event.move 1.2\n\n// One of swipeleft, swiperight, swipeup or swipedown is triggered on\n// moveend, when the move has covered a threshold ratio of the dimension\n// of the target node, or has gone really fast. Threshold and velocity\n// sensitivity changed with:\n//\n// jQuery.event.special.swipe.settings.threshold\n// jQuery.event.special.swipe.settings.sensitivity\n\n(function (thisModule) {\n\tif (typeof define === 'function' && define.amd) {\n // AMD. Register as an anonymous module.\n define(['jquery', undefined, 'jquery.event.move'], thisModule);\n } else if ((typeof module !== \"undefined\" && module !== null) && module.exports) {\n module.exports = thisModule;\n\t} else {\n\t\t// Browser globals\n thisModule(jQuery);\n\t}\n})(function(jQuery, undefined){\n\tvar add = jQuery.event.add,\n\t \n\t remove = jQuery.event.remove,\n\n\t // Just sugar, so we can have arguments in the same order as\n\t // add and remove.\n\t trigger = function(node, type, data) {\n\t \tjQuery.event.trigger(type, data, node);\n\t },\n\n\t settings = {\n\t \t// Ratio of distance over target finger must travel to be\n\t \t// considered a swipe.\n\t \tthreshold: 0.4,\n\t \t// Faster fingers can travel shorter distances to be considered\n\t \t// swipes. 'sensitivity' controls how much. Bigger is shorter.\n\t \tsensitivity: 6\n\t };\n\n\tfunction moveend(e) {\n\t\tvar w, h, event;\n\n\t\tw = e.currentTarget.offsetWidth;\n\t\th = e.currentTarget.offsetHeight;\n\n\t\t// Copy over some useful properties from the move event\n\t\tevent = {\n\t\t\tdistX: e.distX,\n\t\t\tdistY: e.distY,\n\t\t\tvelocityX: e.velocityX,\n\t\t\tvelocityY: e.velocityY,\n\t\t\tfinger: e.finger\n\t\t};\n\n\t\t// Find out which of the four directions was swiped\n\t\tif (e.distX > e.distY) {\n\t\t\tif (e.distX > -e.distY) {\n\t\t\t\tif (e.distX/w > settings.threshold || e.velocityX * e.distX/w * settings.sensitivity > 1) {\n\t\t\t\t\tevent.type = 'swiperight';\n\t\t\t\t\ttrigger(e.currentTarget, event);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse {\n\t\t\t\tif (-e.distY/h > settings.threshold || e.velocityY * e.distY/w * settings.sensitivity > 1) {\n\t\t\t\t\tevent.type = 'swipeup';\n\t\t\t\t\ttrigger(e.currentTarget, event);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\telse {\n\t\t\tif (e.distX > -e.distY) {\n\t\t\t\tif (e.distY/h > settings.threshold || e.velocityY * e.distY/w * settings.sensitivity > 1) {\n\t\t\t\t\tevent.type = 'swipedown';\n\t\t\t\t\ttrigger(e.currentTarget, event);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse {\n\t\t\t\tif (-e.distX/w > settings.threshold || e.velocityX * e.distX/w * settings.sensitivity > 1) {\n\t\t\t\t\tevent.type = 'swipeleft';\n\t\t\t\t\ttrigger(e.currentTarget, event);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tfunction getData(node) {\n\t\tvar data = jQuery.data(node, 'event_swipe');\n\t\t\n\t\tif (!data) {\n\t\t\tdata = { count: 0 };\n\t\t\tjQuery.data(node, 'event_swipe', data);\n\t\t}\n\t\t\n\t\treturn data;\n\t}\n\n\tjQuery.event.special.swipe =\n\tjQuery.event.special.swipeleft =\n\tjQuery.event.special.swiperight =\n\tjQuery.event.special.swipeup =\n\tjQuery.event.special.swipedown = {\n\t\tsetup: function( data, namespaces, eventHandle ) {\n\t\t\tvar data = getData(this);\n\n\t\t\t// If another swipe event is already setup, don't setup again.\n\t\t\tif (data.count++ > 0) { return; }\n\n\t\t\tadd(this, 'moveend', moveend);\n\n\t\t\treturn true;\n\t\t},\n\n\t\tteardown: function() {\n\t\t\tvar data = getData(this);\n\n\t\t\t// If another swipe event is still setup, don't teardown.\n\t\t\tif (--data.count > 0) { return; }\n\n\t\t\tremove(this, 'moveend', moveend);\n\n\t\t\treturn true;\n\t\t},\n\n\t\tsettings: settings\n\t};\n});\n" }, { "path": "package.json", "content": "{\n \"name\": \"jquery.event.swipe\",\n \"title\": \"jquery.event.swipe\",\n \"version\": \"0.5.4\",\n \"author\": {\n \"name\": \"Stephen Band\",\n \"url\": \"http://stephband.info\",\n \"twitter\": \"stephband\"\n },\n \"dependencies\": {\n \"jquery\": \">=1.7.0\",\n \"jquery.event.move\": \"1.x\"\n },\n \"licenses\": [{\"url\": \"http://www.wtfpl.net/txt/copying/\"}],\n \"files\": [\"js/jquery.event.swipe.js\"],\n \"main\": \"js/jquery.event.swipe.js\",\n \"description\": \"jQuery special events for the gestures swipeleft, swiperight, swipeup and swipedown.\",\n \"keywords\": [\"touch\",\"special\",\"event\",\"swipe\",\"dom\",\"jquery\"],\n \"homepage\": \"http://github.com/stephband/jquery.event.swipe\",\n \"docs\": \"http://stephband.info/jquery.event.swipe\"\n}\n" } ]