| @@ 6-749 (lines=744) @@ | ||
| 3 | * (c) 2010-2017 Google, Inc. http://angularjs.org |
|
| 4 | * License: MIT |
|
| 5 | */ |
|
| 6 | (function(window, angular) {'use strict'; |
|
| 7 | ||
| 8 | /* global ngTouchClickDirectiveFactory: false */ |
|
| 9 | ||
| 10 | /** |
|
| 11 | * @ngdoc module |
|
| 12 | * @name ngTouch |
|
| 13 | * @description |
|
| 14 | * |
|
| 15 | * # ngTouch |
|
| 16 | * |
|
| 17 | * The `ngTouch` module provides touch events and other helpers for touch-enabled devices. |
|
| 18 | * The implementation is based on jQuery Mobile touch event handling |
|
| 19 | * ([jquerymobile.com](http://jquerymobile.com/)). |
|
| 20 | * |
|
| 21 | * |
|
| 22 | * See {@link ngTouch.$swipe `$swipe`} for usage. |
|
| 23 | * |
|
| 24 | * <div doc-module-components="ngTouch"></div> |
|
| 25 | * |
|
| 26 | */ |
|
| 27 | ||
| 28 | // define ngTouch module |
|
| 29 | /* global -ngTouch */ |
|
| 30 | var ngTouch = angular.module('ngTouch', []); |
|
| 31 | ||
| 32 | ngTouch.info({ angularVersion: '1.6.5' }); |
|
| 33 | ||
| 34 | ngTouch.provider('$touch', $TouchProvider); |
|
| 35 | ||
| 36 | function nodeName_(element) { |
|
| 37 | return angular.lowercase(element.nodeName || (element[0] && element[0].nodeName)); |
|
| 38 | } |
|
| 39 | ||
| 40 | /** |
|
| 41 | * @ngdoc provider |
|
| 42 | * @name $touchProvider |
|
| 43 | * |
|
| 44 | * @description |
|
| 45 | * The `$touchProvider` allows enabling / disabling {@link ngTouch.ngClick ngTouch's ngClick directive}. |
|
| 46 | */ |
|
| 47 | $TouchProvider.$inject = ['$provide', '$compileProvider']; |
|
| 48 | function $TouchProvider($provide, $compileProvider) { |
|
| 49 | ||
| 50 | /** |
|
| 51 | * @ngdoc method |
|
| 52 | * @name $touchProvider#ngClickOverrideEnabled |
|
| 53 | * |
|
| 54 | * @param {boolean=} enabled update the ngClickOverrideEnabled state if provided, otherwise just return the |
|
| 55 | * current ngClickOverrideEnabled state |
|
| 56 | * @returns {*} current value if used as getter or itself (chaining) if used as setter |
|
| 57 | * |
|
| 58 | * @kind function |
|
| 59 | * |
|
| 60 | * @description |
|
| 61 | * Call this method to enable/disable {@link ngTouch.ngClick ngTouch's ngClick directive}. If enabled, |
|
| 62 | * the default ngClick directive will be replaced by a version that eliminates the 300ms delay for |
|
| 63 | * click events on browser for touch-devices. |
|
| 64 | * |
|
| 65 | * The default is `false`. |
|
| 66 | * |
|
| 67 | */ |
|
| 68 | var ngClickOverrideEnabled = false; |
|
| 69 | var ngClickDirectiveAdded = false; |
|
| 70 | // eslint-disable-next-line no-invalid-this |
|
| 71 | this.ngClickOverrideEnabled = function(enabled) { |
|
| 72 | if (angular.isDefined(enabled)) { |
|
| 73 | ||
| 74 | if (enabled && !ngClickDirectiveAdded) { |
|
| 75 | ngClickDirectiveAdded = true; |
|
| 76 | ||
| 77 | // Use this to identify the correct directive in the delegate |
|
| 78 | ngTouchClickDirectiveFactory.$$moduleName = 'ngTouch'; |
|
| 79 | $compileProvider.directive('ngClick', ngTouchClickDirectiveFactory); |
|
| 80 | ||
| 81 | $provide.decorator('ngClickDirective', ['$delegate', function($delegate) { |
|
| 82 | if (ngClickOverrideEnabled) { |
|
| 83 | // drop the default ngClick directive |
|
| 84 | $delegate.shift(); |
|
| 85 | } else { |
|
| 86 | // drop the ngTouch ngClick directive if the override has been re-disabled (because |
|
| 87 | // we cannot de-register added directives) |
|
| 88 | var i = $delegate.length - 1; |
|
| 89 | while (i >= 0) { |
|
| 90 | if ($delegate[i].$$moduleName === 'ngTouch') { |
|
| 91 | $delegate.splice(i, 1); |
|
| 92 | break; |
|
| 93 | } |
|
| 94 | i--; |
|
| 95 | } |
|
| 96 | } |
|
| 97 | ||
| 98 | return $delegate; |
|
| 99 | }]); |
|
| 100 | } |
|
| 101 | ||
| 102 | ngClickOverrideEnabled = enabled; |
|
| 103 | return this; |
|
| 104 | } |
|
| 105 | ||
| 106 | return ngClickOverrideEnabled; |
|
| 107 | }; |
|
| 108 | ||
| 109 | /** |
|
| 110 | * @ngdoc service |
|
| 111 | * @name $touch |
|
| 112 | * @kind object |
|
| 113 | * |
|
| 114 | * @description |
|
| 115 | * Provides the {@link ngTouch.$touch#ngClickOverrideEnabled `ngClickOverrideEnabled`} method. |
|
| 116 | * |
|
| 117 | */ |
|
| 118 | // eslint-disable-next-line no-invalid-this |
|
| 119 | this.$get = function() { |
|
| 120 | return { |
|
| 121 | /** |
|
| 122 | * @ngdoc method |
|
| 123 | * @name $touch#ngClickOverrideEnabled |
|
| 124 | * |
|
| 125 | * @returns {*} current value of `ngClickOverrideEnabled` set in the {@link ngTouch.$touchProvider $touchProvider}, |
|
| 126 | * i.e. if {@link ngTouch.ngClick ngTouch's ngClick} directive is enabled. |
|
| 127 | * |
|
| 128 | * @kind function |
|
| 129 | */ |
|
| 130 | ngClickOverrideEnabled: function() { |
|
| 131 | return ngClickOverrideEnabled; |
|
| 132 | } |
|
| 133 | }; |
|
| 134 | }; |
|
| 135 | ||
| 136 | } |
|
| 137 | ||
| 138 | /* global ngTouch: false */ |
|
| 139 | ||
| 140 | /** |
|
| 141 | * @ngdoc service |
|
| 142 | * @name $swipe |
|
| 143 | * |
|
| 144 | * @description |
|
| 145 | * The `$swipe` service is a service that abstracts the messier details of hold-and-drag swipe |
|
| 146 | * behavior, to make implementing swipe-related directives more convenient. |
|
| 147 | * |
|
| 148 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 149 | * |
|
| 150 | * `$swipe` is used by the `ngSwipeLeft` and `ngSwipeRight` directives in `ngTouch`. |
|
| 151 | * |
|
| 152 | * # Usage |
|
| 153 | * The `$swipe` service is an object with a single method: `bind`. `bind` takes an element |
|
| 154 | * which is to be watched for swipes, and an object with four handler functions. See the |
|
| 155 | * documentation for `bind` below. |
|
| 156 | */ |
|
| 157 | ||
| 158 | ngTouch.factory('$swipe', [function() { |
|
| 159 | // The total distance in any direction before we make the call on swipe vs. scroll. |
|
| 160 | var MOVE_BUFFER_RADIUS = 10; |
|
| 161 | ||
| 162 | var POINTER_EVENTS = { |
|
| 163 | 'mouse': { |
|
| 164 | start: 'mousedown', |
|
| 165 | move: 'mousemove', |
|
| 166 | end: 'mouseup' |
|
| 167 | }, |
|
| 168 | 'touch': { |
|
| 169 | start: 'touchstart', |
|
| 170 | move: 'touchmove', |
|
| 171 | end: 'touchend', |
|
| 172 | cancel: 'touchcancel' |
|
| 173 | }, |
|
| 174 | 'pointer': { |
|
| 175 | start: 'pointerdown', |
|
| 176 | move: 'pointermove', |
|
| 177 | end: 'pointerup', |
|
| 178 | cancel: 'pointercancel' |
|
| 179 | } |
|
| 180 | }; |
|
| 181 | ||
| 182 | function getCoordinates(event) { |
|
| 183 | var originalEvent = event.originalEvent || event; |
|
| 184 | var touches = originalEvent.touches && originalEvent.touches.length ? originalEvent.touches : [originalEvent]; |
|
| 185 | var e = (originalEvent.changedTouches && originalEvent.changedTouches[0]) || touches[0]; |
|
| 186 | ||
| 187 | return { |
|
| 188 | x: e.clientX, |
|
| 189 | y: e.clientY |
|
| 190 | }; |
|
| 191 | } |
|
| 192 | ||
| 193 | function getEvents(pointerTypes, eventType) { |
|
| 194 | var res = []; |
|
| 195 | angular.forEach(pointerTypes, function(pointerType) { |
|
| 196 | var eventName = POINTER_EVENTS[pointerType][eventType]; |
|
| 197 | if (eventName) { |
|
| 198 | res.push(eventName); |
|
| 199 | } |
|
| 200 | }); |
|
| 201 | return res.join(' '); |
|
| 202 | } |
|
| 203 | ||
| 204 | return { |
|
| 205 | /** |
|
| 206 | * @ngdoc method |
|
| 207 | * @name $swipe#bind |
|
| 208 | * |
|
| 209 | * @description |
|
| 210 | * The main method of `$swipe`. It takes an element to be watched for swipe motions, and an |
|
| 211 | * object containing event handlers. |
|
| 212 | * The pointer types that should be used can be specified via the optional |
|
| 213 | * third argument, which is an array of strings `'mouse'`, `'touch'` and `'pointer'`. By default, |
|
| 214 | * `$swipe` will listen for `mouse`, `touch` and `pointer` events. |
|
| 215 | * |
|
| 216 | * The four events are `start`, `move`, `end`, and `cancel`. `start`, `move`, and `end` |
|
| 217 | * receive as a parameter a coordinates object of the form `{ x: 150, y: 310 }` and the raw |
|
| 218 | * `event`. `cancel` receives the raw `event` as its single parameter. |
|
| 219 | * |
|
| 220 | * `start` is called on either `mousedown`, `touchstart` or `pointerdown`. After this event, `$swipe` is |
|
| 221 | * watching for `touchmove`, `mousemove` or `pointermove` events. These events are ignored until the total |
|
| 222 | * distance moved in either dimension exceeds a small threshold. |
|
| 223 | * |
|
| 224 | * Once this threshold is exceeded, either the horizontal or vertical delta is greater. |
|
| 225 | * - If the horizontal distance is greater, this is a swipe and `move` and `end` events follow. |
|
| 226 | * - If the vertical distance is greater, this is a scroll, and we let the browser take over. |
|
| 227 | * A `cancel` event is sent. |
|
| 228 | * |
|
| 229 | * `move` is called on `mousemove`, `touchmove` and `pointermove` after the above logic has determined that |
|
| 230 | * a swipe is in progress. |
|
| 231 | * |
|
| 232 | * `end` is called when a swipe is successfully completed with a `touchend`, `mouseup` or `pointerup`. |
|
| 233 | * |
|
| 234 | * `cancel` is called either on a `touchcancel` or `pointercancel` from the browser, or when we begin scrolling |
|
| 235 | * as described above. |
|
| 236 | * |
|
| 237 | */ |
|
| 238 | bind: function(element, eventHandlers, pointerTypes) { |
|
| 239 | // Absolute total movement, used to control swipe vs. scroll. |
|
| 240 | var totalX, totalY; |
|
| 241 | // Coordinates of the start position. |
|
| 242 | var startCoords; |
|
| 243 | // Last event's position. |
|
| 244 | var lastPos; |
|
| 245 | // Whether a swipe is active. |
|
| 246 | var active = false; |
|
| 247 | ||
| 248 | pointerTypes = pointerTypes || ['mouse', 'touch', 'pointer']; |
|
| 249 | element.on(getEvents(pointerTypes, 'start'), function(event) { |
|
| 250 | startCoords = getCoordinates(event); |
|
| 251 | active = true; |
|
| 252 | totalX = 0; |
|
| 253 | totalY = 0; |
|
| 254 | lastPos = startCoords; |
|
| 255 | if (eventHandlers['start']) { |
|
| 256 | eventHandlers['start'](startCoords, event); |
|
| 257 | } |
|
| 258 | }); |
|
| 259 | var events = getEvents(pointerTypes, 'cancel'); |
|
| 260 | if (events) { |
|
| 261 | element.on(events, function(event) { |
|
| 262 | active = false; |
|
| 263 | if (eventHandlers['cancel']) { |
|
| 264 | eventHandlers['cancel'](event); |
|
| 265 | } |
|
| 266 | }); |
|
| 267 | } |
|
| 268 | ||
| 269 | element.on(getEvents(pointerTypes, 'move'), function(event) { |
|
| 270 | if (!active) return; |
|
| 271 | ||
| 272 | // Android will send a touchcancel if it thinks we're starting to scroll. |
|
| 273 | // So when the total distance (+ or - or both) exceeds 10px in either direction, |
|
| 274 | // we either: |
|
| 275 | // - On totalX > totalY, we send preventDefault() and treat this as a swipe. |
|
| 276 | // - On totalY > totalX, we let the browser handle it as a scroll. |
|
| 277 | ||
| 278 | if (!startCoords) return; |
|
| 279 | var coords = getCoordinates(event); |
|
| 280 | ||
| 281 | totalX += Math.abs(coords.x - lastPos.x); |
|
| 282 | totalY += Math.abs(coords.y - lastPos.y); |
|
| 283 | ||
| 284 | lastPos = coords; |
|
| 285 | ||
| 286 | if (totalX < MOVE_BUFFER_RADIUS && totalY < MOVE_BUFFER_RADIUS) { |
|
| 287 | return; |
|
| 288 | } |
|
| 289 | ||
| 290 | // One of totalX or totalY has exceeded the buffer, so decide on swipe vs. scroll. |
|
| 291 | if (totalY > totalX) { |
|
| 292 | // Allow native scrolling to take over. |
|
| 293 | active = false; |
|
| 294 | if (eventHandlers['cancel']) { |
|
| 295 | eventHandlers['cancel'](event); |
|
| 296 | } |
|
| 297 | return; |
|
| 298 | } else { |
|
| 299 | // Prevent the browser from scrolling. |
|
| 300 | event.preventDefault(); |
|
| 301 | if (eventHandlers['move']) { |
|
| 302 | eventHandlers['move'](coords, event); |
|
| 303 | } |
|
| 304 | } |
|
| 305 | }); |
|
| 306 | ||
| 307 | element.on(getEvents(pointerTypes, 'end'), function(event) { |
|
| 308 | if (!active) return; |
|
| 309 | active = false; |
|
| 310 | if (eventHandlers['end']) { |
|
| 311 | eventHandlers['end'](getCoordinates(event), event); |
|
| 312 | } |
|
| 313 | }); |
|
| 314 | } |
|
| 315 | }; |
|
| 316 | }]); |
|
| 317 | ||
| 318 | /* global ngTouch: false, |
|
| 319 | nodeName_: false |
|
| 320 | */ |
|
| 321 | ||
| 322 | /** |
|
| 323 | * @ngdoc directive |
|
| 324 | * @name ngClick |
|
| 325 | * @deprecated |
|
| 326 | * sinceVersion="v1.5.0" |
|
| 327 | * This directive is deprecated and **disabled** by default. |
|
| 328 | * The directive will receive no further support and might be removed from future releases. |
|
| 329 | * If you need the directive, you can enable it with the {@link ngTouch.$touchProvider $touchProvider#ngClickOverrideEnabled} |
|
| 330 | * function. We also recommend that you migrate to [FastClick](https://github.com/ftlabs/fastclick). |
|
| 331 | * To learn more about the 300ms delay, this [Telerik article](http://developer.telerik.com/featured/300-ms-click-delay-ios-8/) |
|
| 332 | * gives a good overview. |
|
| 333 | * |
|
| 334 | * @description |
|
| 335 | * A more powerful replacement for the default ngClick designed to be used on touchscreen |
|
| 336 | * devices. Most mobile browsers wait about 300ms after a tap-and-release before sending |
|
| 337 | * the click event. This version handles them immediately, and then prevents the |
|
| 338 | * following click event from propagating. |
|
| 339 | * |
|
| 340 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 341 | * |
|
| 342 | * This directive can fall back to using an ordinary click event, and so works on desktop |
|
| 343 | * browsers as well as mobile. |
|
| 344 | * |
|
| 345 | * This directive also sets the CSS class `ng-click-active` while the element is being held |
|
| 346 | * down (by a mouse click or touch) so you can restyle the depressed element if you wish. |
|
| 347 | * |
|
| 348 | * @element ANY |
|
| 349 | * @param {expression} ngClick {@link guide/expression Expression} to evaluate |
|
| 350 | * upon tap. (Event object is available as `$event`) |
|
| 351 | * |
|
| 352 | * @example |
|
| 353 | <example module="ngClickExample" deps="angular-touch.js" name="ng-touch-ng-click"> |
|
| 354 | <file name="index.html"> |
|
| 355 | <button ng-click="count = count + 1" ng-init="count=0"> |
|
| 356 | Increment |
|
| 357 | </button> |
|
| 358 | count: {{ count }} |
|
| 359 | </file> |
|
| 360 | <file name="script.js"> |
|
| 361 | angular.module('ngClickExample', ['ngTouch']); |
|
| 362 | </file> |
|
| 363 | </example> |
|
| 364 | */ |
|
| 365 | ||
| 366 | var ngTouchClickDirectiveFactory = ['$parse', '$timeout', '$rootElement', |
|
| 367 | function($parse, $timeout, $rootElement) { |
|
| 368 | var TAP_DURATION = 750; // Shorter than 750ms is a tap, longer is a taphold or drag. |
|
| 369 | var MOVE_TOLERANCE = 12; // 12px seems to work in most mobile browsers. |
|
| 370 | var PREVENT_DURATION = 2500; // 2.5 seconds maximum from preventGhostClick call to click |
|
| 371 | var CLICKBUSTER_THRESHOLD = 25; // 25 pixels in any dimension is the limit for busting clicks. |
|
| 372 | ||
| 373 | var ACTIVE_CLASS_NAME = 'ng-click-active'; |
|
| 374 | var lastPreventedTime; |
|
| 375 | var touchCoordinates; |
|
| 376 | var lastLabelClickCoordinates; |
|
| 377 | ||
| 378 | ||
| 379 | // TAP EVENTS AND GHOST CLICKS |
|
| 380 | // |
|
| 381 | // Why tap events? |
|
| 382 | // Mobile browsers detect a tap, then wait a moment (usually ~300ms) to see if you're |
|
| 383 | // double-tapping, and then fire a click event. |
|
| 384 | // |
|
| 385 | // This delay sucks and makes mobile apps feel unresponsive. |
|
| 386 | // So we detect touchstart, touchcancel and touchend ourselves and determine when |
|
| 387 | // the user has tapped on something. |
|
| 388 | // |
|
| 389 | // What happens when the browser then generates a click event? |
|
| 390 | // The browser, of course, also detects the tap and fires a click after a delay. This results in |
|
| 391 | // tapping/clicking twice. We do "clickbusting" to prevent it. |
|
| 392 | // |
|
| 393 | // How does it work? |
|
| 394 | // We attach global touchstart and click handlers, that run during the capture (early) phase. |
|
| 395 | // So the sequence for a tap is: |
|
| 396 | // - global touchstart: Sets an "allowable region" at the point touched. |
|
| 397 | // - element's touchstart: Starts a touch |
|
| 398 | // (- touchcancel ends the touch, no click follows) |
|
| 399 | // - element's touchend: Determines if the tap is valid (didn't move too far away, didn't hold |
|
| 400 | // too long) and fires the user's tap handler. The touchend also calls preventGhostClick(). |
|
| 401 | // - preventGhostClick() removes the allowable region the global touchstart created. |
|
| 402 | // - The browser generates a click event. |
|
| 403 | // - The global click handler catches the click, and checks whether it was in an allowable region. |
|
| 404 | // - If preventGhostClick was called, the region will have been removed, the click is busted. |
|
| 405 | // - If the region is still there, the click proceeds normally. Therefore clicks on links and |
|
| 406 | // other elements without ngTap on them work normally. |
|
| 407 | // |
|
| 408 | // This is an ugly, terrible hack! |
|
| 409 | // Yeah, tell me about it. The alternatives are using the slow click events, or making our users |
|
| 410 | // deal with the ghost clicks, so I consider this the least of evils. Fortunately Angular |
|
| 411 | // encapsulates this ugly logic away from the user. |
|
| 412 | // |
|
| 413 | // Why not just put click handlers on the element? |
|
| 414 | // We do that too, just to be sure. If the tap event caused the DOM to change, |
|
| 415 | // it is possible another element is now in that position. To take account for these possibly |
|
| 416 | // distinct elements, the handlers are global and care only about coordinates. |
|
| 417 | ||
| 418 | // Checks if the coordinates are close enough to be within the region. |
|
| 419 | function hit(x1, y1, x2, y2) { |
|
| 420 | return Math.abs(x1 - x2) < CLICKBUSTER_THRESHOLD && Math.abs(y1 - y2) < CLICKBUSTER_THRESHOLD; |
|
| 421 | } |
|
| 422 | ||
| 423 | // Checks a list of allowable regions against a click location. |
|
| 424 | // Returns true if the click should be allowed. |
|
| 425 | // Splices out the allowable region from the list after it has been used. |
|
| 426 | function checkAllowableRegions(touchCoordinates, x, y) { |
|
| 427 | for (var i = 0; i < touchCoordinates.length; i += 2) { |
|
| 428 | if (hit(touchCoordinates[i], touchCoordinates[i + 1], x, y)) { |
|
| 429 | touchCoordinates.splice(i, i + 2); |
|
| 430 | return true; // allowable region |
|
| 431 | } |
|
| 432 | } |
|
| 433 | return false; // No allowable region; bust it. |
|
| 434 | } |
|
| 435 | ||
| 436 | // Global click handler that prevents the click if it's in a bustable zone and preventGhostClick |
|
| 437 | // was called recently. |
|
| 438 | function onClick(event) { |
|
| 439 | if (Date.now() - lastPreventedTime > PREVENT_DURATION) { |
|
| 440 | return; // Too old. |
|
| 441 | } |
|
| 442 | ||
| 443 | var touches = event.touches && event.touches.length ? event.touches : [event]; |
|
| 444 | var x = touches[0].clientX; |
|
| 445 | var y = touches[0].clientY; |
|
| 446 | // Work around desktop Webkit quirk where clicking a label will fire two clicks (on the label |
|
| 447 | // and on the input element). Depending on the exact browser, this second click we don't want |
|
| 448 | // to bust has either (0,0), negative coordinates, or coordinates equal to triggering label |
|
| 449 | // click event |
|
| 450 | if (x < 1 && y < 1) { |
|
| 451 | return; // offscreen |
|
| 452 | } |
|
| 453 | if (lastLabelClickCoordinates && |
|
| 454 | lastLabelClickCoordinates[0] === x && lastLabelClickCoordinates[1] === y) { |
|
| 455 | return; // input click triggered by label click |
|
| 456 | } |
|
| 457 | // reset label click coordinates on first subsequent click |
|
| 458 | if (lastLabelClickCoordinates) { |
|
| 459 | lastLabelClickCoordinates = null; |
|
| 460 | } |
|
| 461 | // remember label click coordinates to prevent click busting of trigger click event on input |
|
| 462 | if (nodeName_(event.target) === 'label') { |
|
| 463 | lastLabelClickCoordinates = [x, y]; |
|
| 464 | } |
|
| 465 | ||
| 466 | // Look for an allowable region containing this click. |
|
| 467 | // If we find one, that means it was created by touchstart and not removed by |
|
| 468 | // preventGhostClick, so we don't bust it. |
|
| 469 | if (checkAllowableRegions(touchCoordinates, x, y)) { |
|
| 470 | return; |
|
| 471 | } |
|
| 472 | ||
| 473 | // If we didn't find an allowable region, bust the click. |
|
| 474 | event.stopPropagation(); |
|
| 475 | event.preventDefault(); |
|
| 476 | ||
| 477 | // Blur focused form elements |
|
| 478 | if (event.target && event.target.blur) { |
|
| 479 | event.target.blur(); |
|
| 480 | } |
|
| 481 | } |
|
| 482 | ||
| 483 | ||
| 484 | // Global touchstart handler that creates an allowable region for a click event. |
|
| 485 | // This allowable region can be removed by preventGhostClick if we want to bust it. |
|
| 486 | function onTouchStart(event) { |
|
| 487 | var touches = event.touches && event.touches.length ? event.touches : [event]; |
|
| 488 | var x = touches[0].clientX; |
|
| 489 | var y = touches[0].clientY; |
|
| 490 | touchCoordinates.push(x, y); |
|
| 491 | ||
| 492 | $timeout(function() { |
|
| 493 | // Remove the allowable region. |
|
| 494 | for (var i = 0; i < touchCoordinates.length; i += 2) { |
|
| 495 | if (touchCoordinates[i] === x && touchCoordinates[i + 1] === y) { |
|
| 496 | touchCoordinates.splice(i, i + 2); |
|
| 497 | return; |
|
| 498 | } |
|
| 499 | } |
|
| 500 | }, PREVENT_DURATION, false); |
|
| 501 | } |
|
| 502 | ||
| 503 | // On the first call, attaches some event handlers. Then whenever it gets called, it creates a |
|
| 504 | // zone around the touchstart where clicks will get busted. |
|
| 505 | function preventGhostClick(x, y) { |
|
| 506 | if (!touchCoordinates) { |
|
| 507 | $rootElement[0].addEventListener('click', onClick, true); |
|
| 508 | $rootElement[0].addEventListener('touchstart', onTouchStart, true); |
|
| 509 | touchCoordinates = []; |
|
| 510 | } |
|
| 511 | ||
| 512 | lastPreventedTime = Date.now(); |
|
| 513 | ||
| 514 | checkAllowableRegions(touchCoordinates, x, y); |
|
| 515 | } |
|
| 516 | ||
| 517 | // Actual linking function. |
|
| 518 | return function(scope, element, attr) { |
|
| 519 | var clickHandler = $parse(attr.ngClick), |
|
| 520 | tapping = false, |
|
| 521 | tapElement, // Used to blur the element after a tap. |
|
| 522 | startTime, // Used to check if the tap was held too long. |
|
| 523 | touchStartX, |
|
| 524 | touchStartY; |
|
| 525 | ||
| 526 | function resetState() { |
|
| 527 | tapping = false; |
|
| 528 | element.removeClass(ACTIVE_CLASS_NAME); |
|
| 529 | } |
|
| 530 | ||
| 531 | element.on('touchstart', function(event) { |
|
| 532 | tapping = true; |
|
| 533 | tapElement = event.target ? event.target : event.srcElement; // IE uses srcElement. |
|
| 534 | // Hack for Safari, which can target text nodes instead of containers. |
|
| 535 | if (tapElement.nodeType === 3) { |
|
| 536 | tapElement = tapElement.parentNode; |
|
| 537 | } |
|
| 538 | ||
| 539 | element.addClass(ACTIVE_CLASS_NAME); |
|
| 540 | ||
| 541 | startTime = Date.now(); |
|
| 542 | ||
| 543 | // Use jQuery originalEvent |
|
| 544 | var originalEvent = event.originalEvent || event; |
|
| 545 | var touches = originalEvent.touches && originalEvent.touches.length ? originalEvent.touches : [originalEvent]; |
|
| 546 | var e = touches[0]; |
|
| 547 | touchStartX = e.clientX; |
|
| 548 | touchStartY = e.clientY; |
|
| 549 | }); |
|
| 550 | ||
| 551 | element.on('touchcancel', function(event) { |
|
| 552 | resetState(); |
|
| 553 | }); |
|
| 554 | ||
| 555 | element.on('touchend', function(event) { |
|
| 556 | var diff = Date.now() - startTime; |
|
| 557 | ||
| 558 | // Use jQuery originalEvent |
|
| 559 | var originalEvent = event.originalEvent || event; |
|
| 560 | var touches = (originalEvent.changedTouches && originalEvent.changedTouches.length) ? |
|
| 561 | originalEvent.changedTouches : |
|
| 562 | ((originalEvent.touches && originalEvent.touches.length) ? originalEvent.touches : [originalEvent]); |
|
| 563 | var e = touches[0]; |
|
| 564 | var x = e.clientX; |
|
| 565 | var y = e.clientY; |
|
| 566 | var dist = Math.sqrt(Math.pow(x - touchStartX, 2) + Math.pow(y - touchStartY, 2)); |
|
| 567 | ||
| 568 | if (tapping && diff < TAP_DURATION && dist < MOVE_TOLERANCE) { |
|
| 569 | // Call preventGhostClick so the clickbuster will catch the corresponding click. |
|
| 570 | preventGhostClick(x, y); |
|
| 571 | ||
| 572 | // Blur the focused element (the button, probably) before firing the callback. |
|
| 573 | // This doesn't work perfectly on Android Chrome, but seems to work elsewhere. |
|
| 574 | // I couldn't get anything to work reliably on Android Chrome. |
|
| 575 | if (tapElement) { |
|
| 576 | tapElement.blur(); |
|
| 577 | } |
|
| 578 | ||
| 579 | if (!angular.isDefined(attr.disabled) || attr.disabled === false) { |
|
| 580 | element.triggerHandler('click', [event]); |
|
| 581 | } |
|
| 582 | } |
|
| 583 | ||
| 584 | resetState(); |
|
| 585 | }); |
|
| 586 | ||
| 587 | // Hack for iOS Safari's benefit. It goes searching for onclick handlers and is liable to click |
|
| 588 | // something else nearby. |
|
| 589 | element.onclick = function(event) { }; |
|
| 590 | ||
| 591 | // Actual click handler. |
|
| 592 | // There are three different kinds of clicks, only two of which reach this point. |
|
| 593 | // - On desktop browsers without touch events, their clicks will always come here. |
|
| 594 | // - On mobile browsers, the simulated "fast" click will call this. |
|
| 595 | // - But the browser's follow-up slow click will be "busted" before it reaches this handler. |
|
| 596 | // Therefore it's safe to use this directive on both mobile and desktop. |
|
| 597 | element.on('click', function(event, touchend) { |
|
| 598 | scope.$apply(function() { |
|
| 599 | clickHandler(scope, {$event: (touchend || event)}); |
|
| 600 | }); |
|
| 601 | }); |
|
| 602 | ||
| 603 | element.on('mousedown', function(event) { |
|
| 604 | element.addClass(ACTIVE_CLASS_NAME); |
|
| 605 | }); |
|
| 606 | ||
| 607 | element.on('mousemove mouseup', function(event) { |
|
| 608 | element.removeClass(ACTIVE_CLASS_NAME); |
|
| 609 | }); |
|
| 610 | ||
| 611 | }; |
|
| 612 | }]; |
|
| 613 | ||
| 614 | /* global ngTouch: false */ |
|
| 615 | ||
| 616 | /** |
|
| 617 | * @ngdoc directive |
|
| 618 | * @name ngSwipeLeft |
|
| 619 | * |
|
| 620 | * @description |
|
| 621 | * Specify custom behavior when an element is swiped to the left on a touchscreen device. |
|
| 622 | * A leftward swipe is a quick, right-to-left slide of the finger. |
|
| 623 | * Though ngSwipeLeft is designed for touch-based devices, it will work with a mouse click and drag |
|
| 624 | * too. |
|
| 625 | * |
|
| 626 | * To disable the mouse click and drag functionality, add `ng-swipe-disable-mouse` to |
|
| 627 | * the `ng-swipe-left` or `ng-swipe-right` DOM Element. |
|
| 628 | * |
|
| 629 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 630 | * |
|
| 631 | * @element ANY |
|
| 632 | * @param {expression} ngSwipeLeft {@link guide/expression Expression} to evaluate |
|
| 633 | * upon left swipe. (Event object is available as `$event`) |
|
| 634 | * |
|
| 635 | * @example |
|
| 636 | <example module="ngSwipeLeftExample" deps="angular-touch.js" name="ng-swipe-left"> |
|
| 637 | <file name="index.html"> |
|
| 638 | <div ng-show="!showActions" ng-swipe-left="showActions = true"> |
|
| 639 | Some list content, like an email in the inbox |
|
| 640 | </div> |
|
| 641 | <div ng-show="showActions" ng-swipe-right="showActions = false"> |
|
| 642 | <button ng-click="reply()">Reply</button> |
|
| 643 | <button ng-click="delete()">Delete</button> |
|
| 644 | </div> |
|
| 645 | </file> |
|
| 646 | <file name="script.js"> |
|
| 647 | angular.module('ngSwipeLeftExample', ['ngTouch']); |
|
| 648 | </file> |
|
| 649 | </example> |
|
| 650 | */ |
|
| 651 | ||
| 652 | /** |
|
| 653 | * @ngdoc directive |
|
| 654 | * @name ngSwipeRight |
|
| 655 | * |
|
| 656 | * @description |
|
| 657 | * Specify custom behavior when an element is swiped to the right on a touchscreen device. |
|
| 658 | * A rightward swipe is a quick, left-to-right slide of the finger. |
|
| 659 | * Though ngSwipeRight is designed for touch-based devices, it will work with a mouse click and drag |
|
| 660 | * too. |
|
| 661 | * |
|
| 662 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 663 | * |
|
| 664 | * @element ANY |
|
| 665 | * @param {expression} ngSwipeRight {@link guide/expression Expression} to evaluate |
|
| 666 | * upon right swipe. (Event object is available as `$event`) |
|
| 667 | * |
|
| 668 | * @example |
|
| 669 | <example module="ngSwipeRightExample" deps="angular-touch.js" name="ng-swipe-right"> |
|
| 670 | <file name="index.html"> |
|
| 671 | <div ng-show="!showActions" ng-swipe-left="showActions = true"> |
|
| 672 | Some list content, like an email in the inbox |
|
| 673 | </div> |
|
| 674 | <div ng-show="showActions" ng-swipe-right="showActions = false"> |
|
| 675 | <button ng-click="reply()">Reply</button> |
|
| 676 | <button ng-click="delete()">Delete</button> |
|
| 677 | </div> |
|
| 678 | </file> |
|
| 679 | <file name="script.js"> |
|
| 680 | angular.module('ngSwipeRightExample', ['ngTouch']); |
|
| 681 | </file> |
|
| 682 | </example> |
|
| 683 | */ |
|
| 684 | ||
| 685 | function makeSwipeDirective(directiveName, direction, eventName) { |
|
| 686 | ngTouch.directive(directiveName, ['$parse', '$swipe', function($parse, $swipe) { |
|
| 687 | // The maximum vertical delta for a swipe should be less than 75px. |
|
| 688 | var MAX_VERTICAL_DISTANCE = 75; |
|
| 689 | // Vertical distance should not be more than a fraction of the horizontal distance. |
|
| 690 | var MAX_VERTICAL_RATIO = 0.3; |
|
| 691 | // At least a 30px lateral motion is necessary for a swipe. |
|
| 692 | var MIN_HORIZONTAL_DISTANCE = 30; |
|
| 693 | ||
| 694 | return function(scope, element, attr) { |
|
| 695 | var swipeHandler = $parse(attr[directiveName]); |
|
| 696 | ||
| 697 | var startCoords, valid; |
|
| 698 | ||
| 699 | function validSwipe(coords) { |
|
| 700 | // Check that it's within the coordinates. |
|
| 701 | // Absolute vertical distance must be within tolerances. |
|
| 702 | // Horizontal distance, we take the current X - the starting X. |
|
| 703 | // This is negative for leftward swipes and positive for rightward swipes. |
|
| 704 | // After multiplying by the direction (-1 for left, +1 for right), legal swipes |
|
| 705 | // (ie. same direction as the directive wants) will have a positive delta and |
|
| 706 | // illegal ones a negative delta. |
|
| 707 | // Therefore this delta must be positive, and larger than the minimum. |
|
| 708 | if (!startCoords) return false; |
|
| 709 | var deltaY = Math.abs(coords.y - startCoords.y); |
|
| 710 | var deltaX = (coords.x - startCoords.x) * direction; |
|
| 711 | return valid && // Short circuit for already-invalidated swipes. |
|
| 712 | deltaY < MAX_VERTICAL_DISTANCE && |
|
| 713 | deltaX > 0 && |
|
| 714 | deltaX > MIN_HORIZONTAL_DISTANCE && |
|
| 715 | deltaY / deltaX < MAX_VERTICAL_RATIO; |
|
| 716 | } |
|
| 717 | ||
| 718 | var pointerTypes = ['touch']; |
|
| 719 | if (!angular.isDefined(attr['ngSwipeDisableMouse'])) { |
|
| 720 | pointerTypes.push('mouse'); |
|
| 721 | } |
|
| 722 | $swipe.bind(element, { |
|
| 723 | 'start': function(coords, event) { |
|
| 724 | startCoords = coords; |
|
| 725 | valid = true; |
|
| 726 | }, |
|
| 727 | 'cancel': function(event) { |
|
| 728 | valid = false; |
|
| 729 | }, |
|
| 730 | 'end': function(coords, event) { |
|
| 731 | if (validSwipe(coords)) { |
|
| 732 | scope.$apply(function() { |
|
| 733 | element.triggerHandler(eventName); |
|
| 734 | swipeHandler(scope, {$event: event}); |
|
| 735 | }); |
|
| 736 | } |
|
| 737 | } |
|
| 738 | }, pointerTypes); |
|
| 739 | }; |
|
| 740 | }]); |
|
| 741 | } |
|
| 742 | ||
| 743 | // Left is negative X-coordinate, right is positive. |
|
| 744 | makeSwipeDirective('ngSwipeLeft', -1, 'swipeleft'); |
|
| 745 | makeSwipeDirective('ngSwipeRight', 1, 'swiperight'); |
|
| 746 | ||
| 747 | ||
| 748 | ||
| 749 | })(window, window.angular); |
|
| 750 | ||
| @@ 6-749 (lines=744) @@ | ||
| 3 | * (c) 2010-2017 Google, Inc. http://angularjs.org |
|
| 4 | * License: MIT |
|
| 5 | */ |
|
| 6 | (function(window, angular) {'use strict'; |
|
| 7 | ||
| 8 | /* global ngTouchClickDirectiveFactory: false */ |
|
| 9 | ||
| 10 | /** |
|
| 11 | * @ngdoc module |
|
| 12 | * @name ngTouch |
|
| 13 | * @description |
|
| 14 | * |
|
| 15 | * # ngTouch |
|
| 16 | * |
|
| 17 | * The `ngTouch` module provides touch events and other helpers for touch-enabled devices. |
|
| 18 | * The implementation is based on jQuery Mobile touch event handling |
|
| 19 | * ([jquerymobile.com](http://jquerymobile.com/)). |
|
| 20 | * |
|
| 21 | * |
|
| 22 | * See {@link ngTouch.$swipe `$swipe`} for usage. |
|
| 23 | * |
|
| 24 | * <div doc-module-components="ngTouch"></div> |
|
| 25 | * |
|
| 26 | */ |
|
| 27 | ||
| 28 | // define ngTouch module |
|
| 29 | /* global -ngTouch */ |
|
| 30 | var ngTouch = angular.module('ngTouch', []); |
|
| 31 | ||
| 32 | ngTouch.info({ angularVersion: '1.6.4' }); |
|
| 33 | ||
| 34 | ngTouch.provider('$touch', $TouchProvider); |
|
| 35 | ||
| 36 | function nodeName_(element) { |
|
| 37 | return angular.lowercase(element.nodeName || (element[0] && element[0].nodeName)); |
|
| 38 | } |
|
| 39 | ||
| 40 | /** |
|
| 41 | * @ngdoc provider |
|
| 42 | * @name $touchProvider |
|
| 43 | * |
|
| 44 | * @description |
|
| 45 | * The `$touchProvider` allows enabling / disabling {@link ngTouch.ngClick ngTouch's ngClick directive}. |
|
| 46 | */ |
|
| 47 | $TouchProvider.$inject = ['$provide', '$compileProvider']; |
|
| 48 | function $TouchProvider($provide, $compileProvider) { |
|
| 49 | ||
| 50 | /** |
|
| 51 | * @ngdoc method |
|
| 52 | * @name $touchProvider#ngClickOverrideEnabled |
|
| 53 | * |
|
| 54 | * @param {boolean=} enabled update the ngClickOverrideEnabled state if provided, otherwise just return the |
|
| 55 | * current ngClickOverrideEnabled state |
|
| 56 | * @returns {*} current value if used as getter or itself (chaining) if used as setter |
|
| 57 | * |
|
| 58 | * @kind function |
|
| 59 | * |
|
| 60 | * @description |
|
| 61 | * Call this method to enable/disable {@link ngTouch.ngClick ngTouch's ngClick directive}. If enabled, |
|
| 62 | * the default ngClick directive will be replaced by a version that eliminates the 300ms delay for |
|
| 63 | * click events on browser for touch-devices. |
|
| 64 | * |
|
| 65 | * The default is `false`. |
|
| 66 | * |
|
| 67 | */ |
|
| 68 | var ngClickOverrideEnabled = false; |
|
| 69 | var ngClickDirectiveAdded = false; |
|
| 70 | // eslint-disable-next-line no-invalid-this |
|
| 71 | this.ngClickOverrideEnabled = function(enabled) { |
|
| 72 | if (angular.isDefined(enabled)) { |
|
| 73 | ||
| 74 | if (enabled && !ngClickDirectiveAdded) { |
|
| 75 | ngClickDirectiveAdded = true; |
|
| 76 | ||
| 77 | // Use this to identify the correct directive in the delegate |
|
| 78 | ngTouchClickDirectiveFactory.$$moduleName = 'ngTouch'; |
|
| 79 | $compileProvider.directive('ngClick', ngTouchClickDirectiveFactory); |
|
| 80 | ||
| 81 | $provide.decorator('ngClickDirective', ['$delegate', function($delegate) { |
|
| 82 | if (ngClickOverrideEnabled) { |
|
| 83 | // drop the default ngClick directive |
|
| 84 | $delegate.shift(); |
|
| 85 | } else { |
|
| 86 | // drop the ngTouch ngClick directive if the override has been re-disabled (because |
|
| 87 | // we cannot de-register added directives) |
|
| 88 | var i = $delegate.length - 1; |
|
| 89 | while (i >= 0) { |
|
| 90 | if ($delegate[i].$$moduleName === 'ngTouch') { |
|
| 91 | $delegate.splice(i, 1); |
|
| 92 | break; |
|
| 93 | } |
|
| 94 | i--; |
|
| 95 | } |
|
| 96 | } |
|
| 97 | ||
| 98 | return $delegate; |
|
| 99 | }]); |
|
| 100 | } |
|
| 101 | ||
| 102 | ngClickOverrideEnabled = enabled; |
|
| 103 | return this; |
|
| 104 | } |
|
| 105 | ||
| 106 | return ngClickOverrideEnabled; |
|
| 107 | }; |
|
| 108 | ||
| 109 | /** |
|
| 110 | * @ngdoc service |
|
| 111 | * @name $touch |
|
| 112 | * @kind object |
|
| 113 | * |
|
| 114 | * @description |
|
| 115 | * Provides the {@link ngTouch.$touch#ngClickOverrideEnabled `ngClickOverrideEnabled`} method. |
|
| 116 | * |
|
| 117 | */ |
|
| 118 | // eslint-disable-next-line no-invalid-this |
|
| 119 | this.$get = function() { |
|
| 120 | return { |
|
| 121 | /** |
|
| 122 | * @ngdoc method |
|
| 123 | * @name $touch#ngClickOverrideEnabled |
|
| 124 | * |
|
| 125 | * @returns {*} current value of `ngClickOverrideEnabled` set in the {@link ngTouch.$touchProvider $touchProvider}, |
|
| 126 | * i.e. if {@link ngTouch.ngClick ngTouch's ngClick} directive is enabled. |
|
| 127 | * |
|
| 128 | * @kind function |
|
| 129 | */ |
|
| 130 | ngClickOverrideEnabled: function() { |
|
| 131 | return ngClickOverrideEnabled; |
|
| 132 | } |
|
| 133 | }; |
|
| 134 | }; |
|
| 135 | ||
| 136 | } |
|
| 137 | ||
| 138 | /* global ngTouch: false */ |
|
| 139 | ||
| 140 | /** |
|
| 141 | * @ngdoc service |
|
| 142 | * @name $swipe |
|
| 143 | * |
|
| 144 | * @description |
|
| 145 | * The `$swipe` service is a service that abstracts the messier details of hold-and-drag swipe |
|
| 146 | * behavior, to make implementing swipe-related directives more convenient. |
|
| 147 | * |
|
| 148 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 149 | * |
|
| 150 | * `$swipe` is used by the `ngSwipeLeft` and `ngSwipeRight` directives in `ngTouch`. |
|
| 151 | * |
|
| 152 | * # Usage |
|
| 153 | * The `$swipe` service is an object with a single method: `bind`. `bind` takes an element |
|
| 154 | * which is to be watched for swipes, and an object with four handler functions. See the |
|
| 155 | * documentation for `bind` below. |
|
| 156 | */ |
|
| 157 | ||
| 158 | ngTouch.factory('$swipe', [function() { |
|
| 159 | // The total distance in any direction before we make the call on swipe vs. scroll. |
|
| 160 | var MOVE_BUFFER_RADIUS = 10; |
|
| 161 | ||
| 162 | var POINTER_EVENTS = { |
|
| 163 | 'mouse': { |
|
| 164 | start: 'mousedown', |
|
| 165 | move: 'mousemove', |
|
| 166 | end: 'mouseup' |
|
| 167 | }, |
|
| 168 | 'touch': { |
|
| 169 | start: 'touchstart', |
|
| 170 | move: 'touchmove', |
|
| 171 | end: 'touchend', |
|
| 172 | cancel: 'touchcancel' |
|
| 173 | }, |
|
| 174 | 'pointer': { |
|
| 175 | start: 'pointerdown', |
|
| 176 | move: 'pointermove', |
|
| 177 | end: 'pointerup', |
|
| 178 | cancel: 'pointercancel' |
|
| 179 | } |
|
| 180 | }; |
|
| 181 | ||
| 182 | function getCoordinates(event) { |
|
| 183 | var originalEvent = event.originalEvent || event; |
|
| 184 | var touches = originalEvent.touches && originalEvent.touches.length ? originalEvent.touches : [originalEvent]; |
|
| 185 | var e = (originalEvent.changedTouches && originalEvent.changedTouches[0]) || touches[0]; |
|
| 186 | ||
| 187 | return { |
|
| 188 | x: e.clientX, |
|
| 189 | y: e.clientY |
|
| 190 | }; |
|
| 191 | } |
|
| 192 | ||
| 193 | function getEvents(pointerTypes, eventType) { |
|
| 194 | var res = []; |
|
| 195 | angular.forEach(pointerTypes, function(pointerType) { |
|
| 196 | var eventName = POINTER_EVENTS[pointerType][eventType]; |
|
| 197 | if (eventName) { |
|
| 198 | res.push(eventName); |
|
| 199 | } |
|
| 200 | }); |
|
| 201 | return res.join(' '); |
|
| 202 | } |
|
| 203 | ||
| 204 | return { |
|
| 205 | /** |
|
| 206 | * @ngdoc method |
|
| 207 | * @name $swipe#bind |
|
| 208 | * |
|
| 209 | * @description |
|
| 210 | * The main method of `$swipe`. It takes an element to be watched for swipe motions, and an |
|
| 211 | * object containing event handlers. |
|
| 212 | * The pointer types that should be used can be specified via the optional |
|
| 213 | * third argument, which is an array of strings `'mouse'`, `'touch'` and `'pointer'`. By default, |
|
| 214 | * `$swipe` will listen for `mouse`, `touch` and `pointer` events. |
|
| 215 | * |
|
| 216 | * The four events are `start`, `move`, `end`, and `cancel`. `start`, `move`, and `end` |
|
| 217 | * receive as a parameter a coordinates object of the form `{ x: 150, y: 310 }` and the raw |
|
| 218 | * `event`. `cancel` receives the raw `event` as its single parameter. |
|
| 219 | * |
|
| 220 | * `start` is called on either `mousedown`, `touchstart` or `pointerdown`. After this event, `$swipe` is |
|
| 221 | * watching for `touchmove`, `mousemove` or `pointermove` events. These events are ignored until the total |
|
| 222 | * distance moved in either dimension exceeds a small threshold. |
|
| 223 | * |
|
| 224 | * Once this threshold is exceeded, either the horizontal or vertical delta is greater. |
|
| 225 | * - If the horizontal distance is greater, this is a swipe and `move` and `end` events follow. |
|
| 226 | * - If the vertical distance is greater, this is a scroll, and we let the browser take over. |
|
| 227 | * A `cancel` event is sent. |
|
| 228 | * |
|
| 229 | * `move` is called on `mousemove`, `touchmove` and `pointermove` after the above logic has determined that |
|
| 230 | * a swipe is in progress. |
|
| 231 | * |
|
| 232 | * `end` is called when a swipe is successfully completed with a `touchend`, `mouseup` or `pointerup`. |
|
| 233 | * |
|
| 234 | * `cancel` is called either on a `touchcancel` or `pointercancel` from the browser, or when we begin scrolling |
|
| 235 | * as described above. |
|
| 236 | * |
|
| 237 | */ |
|
| 238 | bind: function(element, eventHandlers, pointerTypes) { |
|
| 239 | // Absolute total movement, used to control swipe vs. scroll. |
|
| 240 | var totalX, totalY; |
|
| 241 | // Coordinates of the start position. |
|
| 242 | var startCoords; |
|
| 243 | // Last event's position. |
|
| 244 | var lastPos; |
|
| 245 | // Whether a swipe is active. |
|
| 246 | var active = false; |
|
| 247 | ||
| 248 | pointerTypes = pointerTypes || ['mouse', 'touch', 'pointer']; |
|
| 249 | element.on(getEvents(pointerTypes, 'start'), function(event) { |
|
| 250 | startCoords = getCoordinates(event); |
|
| 251 | active = true; |
|
| 252 | totalX = 0; |
|
| 253 | totalY = 0; |
|
| 254 | lastPos = startCoords; |
|
| 255 | if (eventHandlers['start']) { |
|
| 256 | eventHandlers['start'](startCoords, event); |
|
| 257 | } |
|
| 258 | }); |
|
| 259 | var events = getEvents(pointerTypes, 'cancel'); |
|
| 260 | if (events) { |
|
| 261 | element.on(events, function(event) { |
|
| 262 | active = false; |
|
| 263 | if (eventHandlers['cancel']) { |
|
| 264 | eventHandlers['cancel'](event); |
|
| 265 | } |
|
| 266 | }); |
|
| 267 | } |
|
| 268 | ||
| 269 | element.on(getEvents(pointerTypes, 'move'), function(event) { |
|
| 270 | if (!active) return; |
|
| 271 | ||
| 272 | // Android will send a touchcancel if it thinks we're starting to scroll. |
|
| 273 | // So when the total distance (+ or - or both) exceeds 10px in either direction, |
|
| 274 | // we either: |
|
| 275 | // - On totalX > totalY, we send preventDefault() and treat this as a swipe. |
|
| 276 | // - On totalY > totalX, we let the browser handle it as a scroll. |
|
| 277 | ||
| 278 | if (!startCoords) return; |
|
| 279 | var coords = getCoordinates(event); |
|
| 280 | ||
| 281 | totalX += Math.abs(coords.x - lastPos.x); |
|
| 282 | totalY += Math.abs(coords.y - lastPos.y); |
|
| 283 | ||
| 284 | lastPos = coords; |
|
| 285 | ||
| 286 | if (totalX < MOVE_BUFFER_RADIUS && totalY < MOVE_BUFFER_RADIUS) { |
|
| 287 | return; |
|
| 288 | } |
|
| 289 | ||
| 290 | // One of totalX or totalY has exceeded the buffer, so decide on swipe vs. scroll. |
|
| 291 | if (totalY > totalX) { |
|
| 292 | // Allow native scrolling to take over. |
|
| 293 | active = false; |
|
| 294 | if (eventHandlers['cancel']) { |
|
| 295 | eventHandlers['cancel'](event); |
|
| 296 | } |
|
| 297 | return; |
|
| 298 | } else { |
|
| 299 | // Prevent the browser from scrolling. |
|
| 300 | event.preventDefault(); |
|
| 301 | if (eventHandlers['move']) { |
|
| 302 | eventHandlers['move'](coords, event); |
|
| 303 | } |
|
| 304 | } |
|
| 305 | }); |
|
| 306 | ||
| 307 | element.on(getEvents(pointerTypes, 'end'), function(event) { |
|
| 308 | if (!active) return; |
|
| 309 | active = false; |
|
| 310 | if (eventHandlers['end']) { |
|
| 311 | eventHandlers['end'](getCoordinates(event), event); |
|
| 312 | } |
|
| 313 | }); |
|
| 314 | } |
|
| 315 | }; |
|
| 316 | }]); |
|
| 317 | ||
| 318 | /* global ngTouch: false, |
|
| 319 | nodeName_: false |
|
| 320 | */ |
|
| 321 | ||
| 322 | /** |
|
| 323 | * @ngdoc directive |
|
| 324 | * @name ngClick |
|
| 325 | * @deprecated |
|
| 326 | * sinceVersion="v1.5.0" |
|
| 327 | * This directive is deprecated and **disabled** by default. |
|
| 328 | * The directive will receive no further support and might be removed from future releases. |
|
| 329 | * If you need the directive, you can enable it with the {@link ngTouch.$touchProvider $touchProvider#ngClickOverrideEnabled} |
|
| 330 | * function. We also recommend that you migrate to [FastClick](https://github.com/ftlabs/fastclick). |
|
| 331 | * To learn more about the 300ms delay, this [Telerik article](http://developer.telerik.com/featured/300-ms-click-delay-ios-8/) |
|
| 332 | * gives a good overview. |
|
| 333 | * |
|
| 334 | * @description |
|
| 335 | * A more powerful replacement for the default ngClick designed to be used on touchscreen |
|
| 336 | * devices. Most mobile browsers wait about 300ms after a tap-and-release before sending |
|
| 337 | * the click event. This version handles them immediately, and then prevents the |
|
| 338 | * following click event from propagating. |
|
| 339 | * |
|
| 340 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 341 | * |
|
| 342 | * This directive can fall back to using an ordinary click event, and so works on desktop |
|
| 343 | * browsers as well as mobile. |
|
| 344 | * |
|
| 345 | * This directive also sets the CSS class `ng-click-active` while the element is being held |
|
| 346 | * down (by a mouse click or touch) so you can restyle the depressed element if you wish. |
|
| 347 | * |
|
| 348 | * @element ANY |
|
| 349 | * @param {expression} ngClick {@link guide/expression Expression} to evaluate |
|
| 350 | * upon tap. (Event object is available as `$event`) |
|
| 351 | * |
|
| 352 | * @example |
|
| 353 | <example module="ngClickExample" deps="angular-touch.js" name="ng-touch-ng-click"> |
|
| 354 | <file name="index.html"> |
|
| 355 | <button ng-click="count = count + 1" ng-init="count=0"> |
|
| 356 | Increment |
|
| 357 | </button> |
|
| 358 | count: {{ count }} |
|
| 359 | </file> |
|
| 360 | <file name="script.js"> |
|
| 361 | angular.module('ngClickExample', ['ngTouch']); |
|
| 362 | </file> |
|
| 363 | </example> |
|
| 364 | */ |
|
| 365 | ||
| 366 | var ngTouchClickDirectiveFactory = ['$parse', '$timeout', '$rootElement', |
|
| 367 | function($parse, $timeout, $rootElement) { |
|
| 368 | var TAP_DURATION = 750; // Shorter than 750ms is a tap, longer is a taphold or drag. |
|
| 369 | var MOVE_TOLERANCE = 12; // 12px seems to work in most mobile browsers. |
|
| 370 | var PREVENT_DURATION = 2500; // 2.5 seconds maximum from preventGhostClick call to click |
|
| 371 | var CLICKBUSTER_THRESHOLD = 25; // 25 pixels in any dimension is the limit for busting clicks. |
|
| 372 | ||
| 373 | var ACTIVE_CLASS_NAME = 'ng-click-active'; |
|
| 374 | var lastPreventedTime; |
|
| 375 | var touchCoordinates; |
|
| 376 | var lastLabelClickCoordinates; |
|
| 377 | ||
| 378 | ||
| 379 | // TAP EVENTS AND GHOST CLICKS |
|
| 380 | // |
|
| 381 | // Why tap events? |
|
| 382 | // Mobile browsers detect a tap, then wait a moment (usually ~300ms) to see if you're |
|
| 383 | // double-tapping, and then fire a click event. |
|
| 384 | // |
|
| 385 | // This delay sucks and makes mobile apps feel unresponsive. |
|
| 386 | // So we detect touchstart, touchcancel and touchend ourselves and determine when |
|
| 387 | // the user has tapped on something. |
|
| 388 | // |
|
| 389 | // What happens when the browser then generates a click event? |
|
| 390 | // The browser, of course, also detects the tap and fires a click after a delay. This results in |
|
| 391 | // tapping/clicking twice. We do "clickbusting" to prevent it. |
|
| 392 | // |
|
| 393 | // How does it work? |
|
| 394 | // We attach global touchstart and click handlers, that run during the capture (early) phase. |
|
| 395 | // So the sequence for a tap is: |
|
| 396 | // - global touchstart: Sets an "allowable region" at the point touched. |
|
| 397 | // - element's touchstart: Starts a touch |
|
| 398 | // (- touchcancel ends the touch, no click follows) |
|
| 399 | // - element's touchend: Determines if the tap is valid (didn't move too far away, didn't hold |
|
| 400 | // too long) and fires the user's tap handler. The touchend also calls preventGhostClick(). |
|
| 401 | // - preventGhostClick() removes the allowable region the global touchstart created. |
|
| 402 | // - The browser generates a click event. |
|
| 403 | // - The global click handler catches the click, and checks whether it was in an allowable region. |
|
| 404 | // - If preventGhostClick was called, the region will have been removed, the click is busted. |
|
| 405 | // - If the region is still there, the click proceeds normally. Therefore clicks on links and |
|
| 406 | // other elements without ngTap on them work normally. |
|
| 407 | // |
|
| 408 | // This is an ugly, terrible hack! |
|
| 409 | // Yeah, tell me about it. The alternatives are using the slow click events, or making our users |
|
| 410 | // deal with the ghost clicks, so I consider this the least of evils. Fortunately Angular |
|
| 411 | // encapsulates this ugly logic away from the user. |
|
| 412 | // |
|
| 413 | // Why not just put click handlers on the element? |
|
| 414 | // We do that too, just to be sure. If the tap event caused the DOM to change, |
|
| 415 | // it is possible another element is now in that position. To take account for these possibly |
|
| 416 | // distinct elements, the handlers are global and care only about coordinates. |
|
| 417 | ||
| 418 | // Checks if the coordinates are close enough to be within the region. |
|
| 419 | function hit(x1, y1, x2, y2) { |
|
| 420 | return Math.abs(x1 - x2) < CLICKBUSTER_THRESHOLD && Math.abs(y1 - y2) < CLICKBUSTER_THRESHOLD; |
|
| 421 | } |
|
| 422 | ||
| 423 | // Checks a list of allowable regions against a click location. |
|
| 424 | // Returns true if the click should be allowed. |
|
| 425 | // Splices out the allowable region from the list after it has been used. |
|
| 426 | function checkAllowableRegions(touchCoordinates, x, y) { |
|
| 427 | for (var i = 0; i < touchCoordinates.length; i += 2) { |
|
| 428 | if (hit(touchCoordinates[i], touchCoordinates[i + 1], x, y)) { |
|
| 429 | touchCoordinates.splice(i, i + 2); |
|
| 430 | return true; // allowable region |
|
| 431 | } |
|
| 432 | } |
|
| 433 | return false; // No allowable region; bust it. |
|
| 434 | } |
|
| 435 | ||
| 436 | // Global click handler that prevents the click if it's in a bustable zone and preventGhostClick |
|
| 437 | // was called recently. |
|
| 438 | function onClick(event) { |
|
| 439 | if (Date.now() - lastPreventedTime > PREVENT_DURATION) { |
|
| 440 | return; // Too old. |
|
| 441 | } |
|
| 442 | ||
| 443 | var touches = event.touches && event.touches.length ? event.touches : [event]; |
|
| 444 | var x = touches[0].clientX; |
|
| 445 | var y = touches[0].clientY; |
|
| 446 | // Work around desktop Webkit quirk where clicking a label will fire two clicks (on the label |
|
| 447 | // and on the input element). Depending on the exact browser, this second click we don't want |
|
| 448 | // to bust has either (0,0), negative coordinates, or coordinates equal to triggering label |
|
| 449 | // click event |
|
| 450 | if (x < 1 && y < 1) { |
|
| 451 | return; // offscreen |
|
| 452 | } |
|
| 453 | if (lastLabelClickCoordinates && |
|
| 454 | lastLabelClickCoordinates[0] === x && lastLabelClickCoordinates[1] === y) { |
|
| 455 | return; // input click triggered by label click |
|
| 456 | } |
|
| 457 | // reset label click coordinates on first subsequent click |
|
| 458 | if (lastLabelClickCoordinates) { |
|
| 459 | lastLabelClickCoordinates = null; |
|
| 460 | } |
|
| 461 | // remember label click coordinates to prevent click busting of trigger click event on input |
|
| 462 | if (nodeName_(event.target) === 'label') { |
|
| 463 | lastLabelClickCoordinates = [x, y]; |
|
| 464 | } |
|
| 465 | ||
| 466 | // Look for an allowable region containing this click. |
|
| 467 | // If we find one, that means it was created by touchstart and not removed by |
|
| 468 | // preventGhostClick, so we don't bust it. |
|
| 469 | if (checkAllowableRegions(touchCoordinates, x, y)) { |
|
| 470 | return; |
|
| 471 | } |
|
| 472 | ||
| 473 | // If we didn't find an allowable region, bust the click. |
|
| 474 | event.stopPropagation(); |
|
| 475 | event.preventDefault(); |
|
| 476 | ||
| 477 | // Blur focused form elements |
|
| 478 | if (event.target && event.target.blur) { |
|
| 479 | event.target.blur(); |
|
| 480 | } |
|
| 481 | } |
|
| 482 | ||
| 483 | ||
| 484 | // Global touchstart handler that creates an allowable region for a click event. |
|
| 485 | // This allowable region can be removed by preventGhostClick if we want to bust it. |
|
| 486 | function onTouchStart(event) { |
|
| 487 | var touches = event.touches && event.touches.length ? event.touches : [event]; |
|
| 488 | var x = touches[0].clientX; |
|
| 489 | var y = touches[0].clientY; |
|
| 490 | touchCoordinates.push(x, y); |
|
| 491 | ||
| 492 | $timeout(function() { |
|
| 493 | // Remove the allowable region. |
|
| 494 | for (var i = 0; i < touchCoordinates.length; i += 2) { |
|
| 495 | if (touchCoordinates[i] === x && touchCoordinates[i + 1] === y) { |
|
| 496 | touchCoordinates.splice(i, i + 2); |
|
| 497 | return; |
|
| 498 | } |
|
| 499 | } |
|
| 500 | }, PREVENT_DURATION, false); |
|
| 501 | } |
|
| 502 | ||
| 503 | // On the first call, attaches some event handlers. Then whenever it gets called, it creates a |
|
| 504 | // zone around the touchstart where clicks will get busted. |
|
| 505 | function preventGhostClick(x, y) { |
|
| 506 | if (!touchCoordinates) { |
|
| 507 | $rootElement[0].addEventListener('click', onClick, true); |
|
| 508 | $rootElement[0].addEventListener('touchstart', onTouchStart, true); |
|
| 509 | touchCoordinates = []; |
|
| 510 | } |
|
| 511 | ||
| 512 | lastPreventedTime = Date.now(); |
|
| 513 | ||
| 514 | checkAllowableRegions(touchCoordinates, x, y); |
|
| 515 | } |
|
| 516 | ||
| 517 | // Actual linking function. |
|
| 518 | return function(scope, element, attr) { |
|
| 519 | var clickHandler = $parse(attr.ngClick), |
|
| 520 | tapping = false, |
|
| 521 | tapElement, // Used to blur the element after a tap. |
|
| 522 | startTime, // Used to check if the tap was held too long. |
|
| 523 | touchStartX, |
|
| 524 | touchStartY; |
|
| 525 | ||
| 526 | function resetState() { |
|
| 527 | tapping = false; |
|
| 528 | element.removeClass(ACTIVE_CLASS_NAME); |
|
| 529 | } |
|
| 530 | ||
| 531 | element.on('touchstart', function(event) { |
|
| 532 | tapping = true; |
|
| 533 | tapElement = event.target ? event.target : event.srcElement; // IE uses srcElement. |
|
| 534 | // Hack for Safari, which can target text nodes instead of containers. |
|
| 535 | if (tapElement.nodeType === 3) { |
|
| 536 | tapElement = tapElement.parentNode; |
|
| 537 | } |
|
| 538 | ||
| 539 | element.addClass(ACTIVE_CLASS_NAME); |
|
| 540 | ||
| 541 | startTime = Date.now(); |
|
| 542 | ||
| 543 | // Use jQuery originalEvent |
|
| 544 | var originalEvent = event.originalEvent || event; |
|
| 545 | var touches = originalEvent.touches && originalEvent.touches.length ? originalEvent.touches : [originalEvent]; |
|
| 546 | var e = touches[0]; |
|
| 547 | touchStartX = e.clientX; |
|
| 548 | touchStartY = e.clientY; |
|
| 549 | }); |
|
| 550 | ||
| 551 | element.on('touchcancel', function(event) { |
|
| 552 | resetState(); |
|
| 553 | }); |
|
| 554 | ||
| 555 | element.on('touchend', function(event) { |
|
| 556 | var diff = Date.now() - startTime; |
|
| 557 | ||
| 558 | // Use jQuery originalEvent |
|
| 559 | var originalEvent = event.originalEvent || event; |
|
| 560 | var touches = (originalEvent.changedTouches && originalEvent.changedTouches.length) ? |
|
| 561 | originalEvent.changedTouches : |
|
| 562 | ((originalEvent.touches && originalEvent.touches.length) ? originalEvent.touches : [originalEvent]); |
|
| 563 | var e = touches[0]; |
|
| 564 | var x = e.clientX; |
|
| 565 | var y = e.clientY; |
|
| 566 | var dist = Math.sqrt(Math.pow(x - touchStartX, 2) + Math.pow(y - touchStartY, 2)); |
|
| 567 | ||
| 568 | if (tapping && diff < TAP_DURATION && dist < MOVE_TOLERANCE) { |
|
| 569 | // Call preventGhostClick so the clickbuster will catch the corresponding click. |
|
| 570 | preventGhostClick(x, y); |
|
| 571 | ||
| 572 | // Blur the focused element (the button, probably) before firing the callback. |
|
| 573 | // This doesn't work perfectly on Android Chrome, but seems to work elsewhere. |
|
| 574 | // I couldn't get anything to work reliably on Android Chrome. |
|
| 575 | if (tapElement) { |
|
| 576 | tapElement.blur(); |
|
| 577 | } |
|
| 578 | ||
| 579 | if (!angular.isDefined(attr.disabled) || attr.disabled === false) { |
|
| 580 | element.triggerHandler('click', [event]); |
|
| 581 | } |
|
| 582 | } |
|
| 583 | ||
| 584 | resetState(); |
|
| 585 | }); |
|
| 586 | ||
| 587 | // Hack for iOS Safari's benefit. It goes searching for onclick handlers and is liable to click |
|
| 588 | // something else nearby. |
|
| 589 | element.onclick = function(event) { }; |
|
| 590 | ||
| 591 | // Actual click handler. |
|
| 592 | // There are three different kinds of clicks, only two of which reach this point. |
|
| 593 | // - On desktop browsers without touch events, their clicks will always come here. |
|
| 594 | // - On mobile browsers, the simulated "fast" click will call this. |
|
| 595 | // - But the browser's follow-up slow click will be "busted" before it reaches this handler. |
|
| 596 | // Therefore it's safe to use this directive on both mobile and desktop. |
|
| 597 | element.on('click', function(event, touchend) { |
|
| 598 | scope.$apply(function() { |
|
| 599 | clickHandler(scope, {$event: (touchend || event)}); |
|
| 600 | }); |
|
| 601 | }); |
|
| 602 | ||
| 603 | element.on('mousedown', function(event) { |
|
| 604 | element.addClass(ACTIVE_CLASS_NAME); |
|
| 605 | }); |
|
| 606 | ||
| 607 | element.on('mousemove mouseup', function(event) { |
|
| 608 | element.removeClass(ACTIVE_CLASS_NAME); |
|
| 609 | }); |
|
| 610 | ||
| 611 | }; |
|
| 612 | }]; |
|
| 613 | ||
| 614 | /* global ngTouch: false */ |
|
| 615 | ||
| 616 | /** |
|
| 617 | * @ngdoc directive |
|
| 618 | * @name ngSwipeLeft |
|
| 619 | * |
|
| 620 | * @description |
|
| 621 | * Specify custom behavior when an element is swiped to the left on a touchscreen device. |
|
| 622 | * A leftward swipe is a quick, right-to-left slide of the finger. |
|
| 623 | * Though ngSwipeLeft is designed for touch-based devices, it will work with a mouse click and drag |
|
| 624 | * too. |
|
| 625 | * |
|
| 626 | * To disable the mouse click and drag functionality, add `ng-swipe-disable-mouse` to |
|
| 627 | * the `ng-swipe-left` or `ng-swipe-right` DOM Element. |
|
| 628 | * |
|
| 629 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 630 | * |
|
| 631 | * @element ANY |
|
| 632 | * @param {expression} ngSwipeLeft {@link guide/expression Expression} to evaluate |
|
| 633 | * upon left swipe. (Event object is available as `$event`) |
|
| 634 | * |
|
| 635 | * @example |
|
| 636 | <example module="ngSwipeLeftExample" deps="angular-touch.js" name="ng-swipe-left"> |
|
| 637 | <file name="index.html"> |
|
| 638 | <div ng-show="!showActions" ng-swipe-left="showActions = true"> |
|
| 639 | Some list content, like an email in the inbox |
|
| 640 | </div> |
|
| 641 | <div ng-show="showActions" ng-swipe-right="showActions = false"> |
|
| 642 | <button ng-click="reply()">Reply</button> |
|
| 643 | <button ng-click="delete()">Delete</button> |
|
| 644 | </div> |
|
| 645 | </file> |
|
| 646 | <file name="script.js"> |
|
| 647 | angular.module('ngSwipeLeftExample', ['ngTouch']); |
|
| 648 | </file> |
|
| 649 | </example> |
|
| 650 | */ |
|
| 651 | ||
| 652 | /** |
|
| 653 | * @ngdoc directive |
|
| 654 | * @name ngSwipeRight |
|
| 655 | * |
|
| 656 | * @description |
|
| 657 | * Specify custom behavior when an element is swiped to the right on a touchscreen device. |
|
| 658 | * A rightward swipe is a quick, left-to-right slide of the finger. |
|
| 659 | * Though ngSwipeRight is designed for touch-based devices, it will work with a mouse click and drag |
|
| 660 | * too. |
|
| 661 | * |
|
| 662 | * Requires the {@link ngTouch `ngTouch`} module to be installed. |
|
| 663 | * |
|
| 664 | * @element ANY |
|
| 665 | * @param {expression} ngSwipeRight {@link guide/expression Expression} to evaluate |
|
| 666 | * upon right swipe. (Event object is available as `$event`) |
|
| 667 | * |
|
| 668 | * @example |
|
| 669 | <example module="ngSwipeRightExample" deps="angular-touch.js" name="ng-swipe-right"> |
|
| 670 | <file name="index.html"> |
|
| 671 | <div ng-show="!showActions" ng-swipe-left="showActions = true"> |
|
| 672 | Some list content, like an email in the inbox |
|
| 673 | </div> |
|
| 674 | <div ng-show="showActions" ng-swipe-right="showActions = false"> |
|
| 675 | <button ng-click="reply()">Reply</button> |
|
| 676 | <button ng-click="delete()">Delete</button> |
|
| 677 | </div> |
|
| 678 | </file> |
|
| 679 | <file name="script.js"> |
|
| 680 | angular.module('ngSwipeRightExample', ['ngTouch']); |
|
| 681 | </file> |
|
| 682 | </example> |
|
| 683 | */ |
|
| 684 | ||
| 685 | function makeSwipeDirective(directiveName, direction, eventName) { |
|
| 686 | ngTouch.directive(directiveName, ['$parse', '$swipe', function($parse, $swipe) { |
|
| 687 | // The maximum vertical delta for a swipe should be less than 75px. |
|
| 688 | var MAX_VERTICAL_DISTANCE = 75; |
|
| 689 | // Vertical distance should not be more than a fraction of the horizontal distance. |
|
| 690 | var MAX_VERTICAL_RATIO = 0.3; |
|
| 691 | // At least a 30px lateral motion is necessary for a swipe. |
|
| 692 | var MIN_HORIZONTAL_DISTANCE = 30; |
|
| 693 | ||
| 694 | return function(scope, element, attr) { |
|
| 695 | var swipeHandler = $parse(attr[directiveName]); |
|
| 696 | ||
| 697 | var startCoords, valid; |
|
| 698 | ||
| 699 | function validSwipe(coords) { |
|
| 700 | // Check that it's within the coordinates. |
|
| 701 | // Absolute vertical distance must be within tolerances. |
|
| 702 | // Horizontal distance, we take the current X - the starting X. |
|
| 703 | // This is negative for leftward swipes and positive for rightward swipes. |
|
| 704 | // After multiplying by the direction (-1 for left, +1 for right), legal swipes |
|
| 705 | // (ie. same direction as the directive wants) will have a positive delta and |
|
| 706 | // illegal ones a negative delta. |
|
| 707 | // Therefore this delta must be positive, and larger than the minimum. |
|
| 708 | if (!startCoords) return false; |
|
| 709 | var deltaY = Math.abs(coords.y - startCoords.y); |
|
| 710 | var deltaX = (coords.x - startCoords.x) * direction; |
|
| 711 | return valid && // Short circuit for already-invalidated swipes. |
|
| 712 | deltaY < MAX_VERTICAL_DISTANCE && |
|
| 713 | deltaX > 0 && |
|
| 714 | deltaX > MIN_HORIZONTAL_DISTANCE && |
|
| 715 | deltaY / deltaX < MAX_VERTICAL_RATIO; |
|
| 716 | } |
|
| 717 | ||
| 718 | var pointerTypes = ['touch']; |
|
| 719 | if (!angular.isDefined(attr['ngSwipeDisableMouse'])) { |
|
| 720 | pointerTypes.push('mouse'); |
|
| 721 | } |
|
| 722 | $swipe.bind(element, { |
|
| 723 | 'start': function(coords, event) { |
|
| 724 | startCoords = coords; |
|
| 725 | valid = true; |
|
| 726 | }, |
|
| 727 | 'cancel': function(event) { |
|
| 728 | valid = false; |
|
| 729 | }, |
|
| 730 | 'end': function(coords, event) { |
|
| 731 | if (validSwipe(coords)) { |
|
| 732 | scope.$apply(function() { |
|
| 733 | element.triggerHandler(eventName); |
|
| 734 | swipeHandler(scope, {$event: event}); |
|
| 735 | }); |
|
| 736 | } |
|
| 737 | } |
|
| 738 | }, pointerTypes); |
|
| 739 | }; |
|
| 740 | }]); |
|
| 741 | } |
|
| 742 | ||
| 743 | // Left is negative X-coordinate, right is positive. |
|
| 744 | makeSwipeDirective('ngSwipeLeft', -1, 'swipeleft'); |
|
| 745 | makeSwipeDirective('ngSwipeRight', 1, 'swiperight'); |
|
| 746 | ||
| 747 | ||
| 748 | ||
| 749 | })(window, window.angular); |
|
| 750 | ||