\n // ---- Angular Hammer ----\n\n// Copyright (c) 2015 Ryan S Mullins <ryan@ryanmullins.org>\n// Licensed under the MIT Software License\n//\n// (fairly heavy) modifications by James Wilson <me@unbui.lt>\n//\n\n(function (window, angular, Hammer) {\n 'use strict';\n\n // Checking to make sure Hammer and Angular are defined\n\n if (typeof angular === 'undefined') {\n throw Error(\"angular-hammer: AngularJS (window.angular) is undefined but is necessary.\");\n }\n if (typeof Hammer === 'undefined') {\n throw Error(\"angular-hammer: HammerJS (window.Hammer) is undefined but is necessary.\");\n }\n\n /**\n * Mapping of the gesture event names with the Angular attribute directive\n * names. Follows the form: <directiveName>:<eventName>.\n *\n * @type {Array}\n */\n var gestureTypes = [\n 'hmCustom:custom',\n 'hmSwipe:swipe',\n 'hmSwipeleft:swipeleft',\n 'hmSwiperight:swiperight',\n 'hmSwipeup:swipeup',\n 'hmSwipedown:swipedown',\n 'hmPan:pan',\n 'hmPanstart:panstart',\n 'hmPanmove:panmove',\n 'hmPanend:panend',\n 'hmPancancel:pancancel',\n 'hmPanleft:panleft',\n 'hmPanright:panright',\n 'hmPanup:panup',\n 'hmPandown:pandown',\n 'hmPress:press',\n 'hmPressup:pressup',\n 'hmRotate:rotate',\n 'hmRotatestart:rotatestart',\n 'hmRotatemove:rotatemove',\n 'hmRotateend:rotateend',\n 'hmRotatecancel:rotatecancel',\n 'hmPinch:pinch',\n 'hmPinchstart:pinchstart',\n 'hmPinchmove:pinchmove',\n 'hmPinchend:pinchend',\n 'hmPinchcancel:pinchcancel',\n 'hmPinchin:pinchin',\n 'hmPinchout:pinchout',\n 'hmTap:tap',\n 'hmDoubletap:doubletap'\n ];\n\n // ---- Module Definition ----\n\n /**\n * @module hmTouchEvents\n * @description Angular.js module for adding Hammer.js event listeners to HTML\n * elements using attribute directives\n * @requires angular\n * @requires hammer\n */\n var NAME = 'hmTouchEvents';\n var hmTouchEvents = angular.module('hmTouchEvents', []);\n\n /**\n * Provides a common interface for configuring global manager and recognizer\n * options. Allows things like tap duration etc to be defaulted globally and\n * overridden on a per-directive basis as needed.\n *\n * @return {Object} functions to add manager and recognizer options.\n */\n hmTouchEvents.provider(NAME, function(){\n\n var self = this;\n var defaultRecognizerOpts = false;\n var recognizerOptsHash = {};\n var managerOpts = {};\n\n //\n // In order to use the Hamme rpresets provided, we need\n // to map the recognizer fn to some name:\n //\n var recognizerFnToName = {};\n recognizerFnToName[ Hammer.Tap.toString() ] = \"tap\";\n recognizerFnToName[ Hammer.Pan.toString() ] = \"pan\";\n recognizerFnToName[ Hammer.Pinch.toString() ] = \"pinch\";\n recognizerFnToName[ Hammer.Press.toString() ] = \"press\";\n recognizerFnToName[ Hammer.Rotate.toString() ] = \"rotate\";\n recognizerFnToName[ Hammer.Swipe.toString() ] = \"swipe\";\n\n //\n // normalize opts, setting its name as it should be keyed by\n // and any must-have options. currently only doubletap is treated\n // specially. each _name leads to a new recognizer.\n //\n function normalizeRecognizerOptions(opts){\n opts = angular.copy(opts);\n\n if(opts.event){\n\n if(opts.event == \"doubletap\"){\n opts.type = \"tap\";\n if(!opts.taps) opts.taps = 2;\n opts._name = \"doubletap\";\n } else {\n opts._name = false;\n }\n\n } else {\n opts._name = opts.type || false;\n }\n\n return opts;\n }\n //\n // create default opts for some eventName.\n // again, treat doubletap specially.\n //\n function defaultOptionsForEvent(eventName){\n if(eventName == \"custom\"){\n throw Error(NAME+\"Provider: no defaults exist for custom events\");\n }\n var ty = getRecognizerTypeFromeventName(eventName);\n return normalizeRecognizerOptions(\n eventName == \"doubletap\"\n ? {type:ty, event:\"doubletap\"}\n : {type:ty}\n );\n }\n\n //\n // Make use of presets from Hammer.defaults.preset array\n // in angular-hammer events.\n //\n self.applyHammerPresets = function(){\n var hammerPresets = Hammer.defaults.preset;\n\n //add every preset that, when normalized, has a _name.\n //this precludes most custom events.\n angular.forEach(hammerPresets, function(presetArr){\n\n var data = presetArr[1];\n if(!data.type) data.type = recognizerFnToName[presetArr[0]];\n data = normalizeRecognizerOptions(data);\n if(!data._name) return;\n recognizerOptsHash[data._name] = data;\n });\n }\n\n //\n // Add a manager option (key/val to extend or object to set all):\n //\n self.addManagerOption = function(name, val){\n if(typeof name == \"object\"){\n angular.extend(managerOpts, name);\n }\n else {\n managerOpts[name] = val;\n }\n }\n\n //\n // Add a recognizer option:\n //\n self.addRecognizerOption = function(val){\n if(Array.isArray(val)){\n for(var i = 0; i < val.length; i++) self.addRecognizerOption(val[i]);\n return;\n }\n if(typeof val !== \"object\"){\n throw Error(NAME+\"Provider: addRecognizerOption: should be object or array of objects\");\n }\n val = normalizeRecognizerOptions(val);\n\n //hash by name if present, else if no event name,\n //set as defaults.\n if(val._name){\n recognizerOptsHash[val.type] = val;\n } else if(!val.event){\n defaultRecognizerOpts = val;\n }\n\n }\n\n //provide an interface to this that the hm-* directives use\n //to extend their recognizer/manager opts.\n self.$get = function(){\n return {\n extendWithDefaultManagerOpts: function(opts){\n if(typeof opts != \"object\"){\n opts = {};\n } else {\n opts = angular.copy(opts);\n }\n for(var name in managerOpts) {\n if(!opts[name]) opts[name] = angular.copy(managerOpts[name]);\n }\n return opts;\n },\n extendWithDefaultRecognizerOpts: function(eventName, opts){\n if(typeof opts !== \"object\"){\n opts = [];\n }\n if(!Array.isArray(opts)){\n opts = [opts];\n }\n\n //dont apply anything if this is custom event\n //(beyond normalizing opts to an array):\n if(eventName == \"custom\") return opts;\n\n var recognizerType = getRecognizerTypeFromeventName(eventName);\n var specificOpts = recognizerOptsHash[eventName] || recognizerOptsHash[recognizerType];\n\n //get the last opt provided that matches the type or eventName\n //that we have. normalizing removes any eventnames we dont care about\n //(everything but doubletap at the moment).\n var foundOpt;\n var isExactMatch = false;\n var defaults = angular.extend({}, defaultRecognizerOpts || {}, specificOpts || {});\n opts.forEach(function(opt){\n\n if(!opt.event && !opt.type){\n return angular.extend(defaults, opt);\n }\n if(isExactMatch){\n return;\n }\n\n //more specific wins over less specific.\n if(opt.event == eventName){\n foundOpt = opt;\n isExactMatch = true;\n } else if(!opt.event && opt.type == recognizerType){\n foundOpt = opt;\n }\n\n });\n if(!foundOpt) foundOpt = defaultOptionsForEvent(eventName);\n else foundOpt = normalizeRecognizerOptions(foundOpt);\n\n\n return [angular.extend(defaults, foundOpt)];\n }\n };\n };\n\n });\n\n /**\n * Iterates through each gesture type mapping and creates a directive for\n * each of the\n *\n * @param {String} type Mapping in the form of <directiveName>:<eventName>\n * @return None\n */\n angular.forEach(gestureTypes, function (type) {\n var directive = type.split(':'),\n directiveName = directive[0],\n eventName = directive[1];\n\n hmTouchEvents.directive(directiveName, ['$parse', '$window', NAME, function ($parse, $window, defaultEvents) {\n return {\n restrict: 'A',\n scope: false,\n link: function (scope, element, attrs) {\n\n // Check for Hammer and required functionality.\n // error if they arent found as unexpected behaviour otherwise\n if (!Hammer || !$window.addEventListener) {\n throw Error(NAME+\": window.Hammer or window.addEventListener not found, can't add event \"+directiveName);\n }\n\n var hammer = element.data('hammer'),\n managerOpts = defaultEvents.extendWithDefaultManagerOpts( scope.$eval(attrs.hmManagerOptions) ),\n recognizerOpts = defaultEvents.extendWithDefaultRecognizerOpts( eventName, scope.$eval(attrs.hmRecognizerOptions) );\n\n // Check for a manager, make one if needed and destroy it when\n // the scope is destroyed\n if (!hammer) {\n hammer = new Hammer.Manager(element[0], managerOpts);\n element.data('hammer', hammer);\n scope.$on('$destroy', function () {\n hammer.destroy();\n });\n }\n\n // Obtain and wrap our handler function to do a couple of bits for\n // us if options provided.\n var handlerExpr = $parse(attrs[directiveName]).bind(null,scope);\n var handler = function (event) {\n event.element = element;\n\n var recognizer = hammer.get(event.type);\n if (recognizer) {\n if (recognizer.options.preventDefault) {\n event.preventDefault();\n }\n if (recognizer.options.stopPropagation) {\n event.srcEvent.stopPropagation();\n }\n }\n\n scope.$apply(function(){\n handlerExpr({ '$event': event });\n });\n };\n\n // The recognizer options are normalized to an array. This array\n // contains whatever events we wish to add (our prior extending\n // takes care of that), but we do a couple of specific things\n // depending on this directive so that events play nice together.\n angular.forEach(recognizerOpts, function (options) {\n\n if(eventName !== 'custom'){\n\n if (eventName === 'doubletap' && hammer.get('tap')) {\n options.recognizeWith = 'tap';\n }\n else if (options.type == \"pan\" && hammer.get('swipe')) {\n options.recognizeWith = 'swipe';\n }\n else if (options.type == \"pinch\" && hammer.get('rotate')) {\n options.recognizeWith = 'rotate';\n }\n\n }\n\n //add the recognizer with these options:\n setupRecognizerWithOptions(\n hammer,\n applyManagerOptions(managerOpts, options),\n element\n );\n\n //if custom there may be multiple events to apply, which\n //we do here. else, we'll only ever add one.\n hammer.on(eventName, handler);\n\n });\n\n }\n };\n }]);\n });\n\n // ---- Private Functions -----\n\n /**\n * Adds a gesture recognizer to a given manager. The type of recognizer to\n * add is determined by the value of the options.type property.\n *\n * @param {Object} manager Hammer.js manager object assigned to an element\n * @param {String} type Options that define the recognizer to add\n * @return {Object} Reference to the new gesture recognizer, if\n * successful, null otherwise.\n */\n function addRecognizer (manager, name) {\n if (manager === undefined || name === undefined) { return null; }\n\n var recognizer;\n\n if (name.indexOf('pan') > -1) {\n recognizer = new Hammer.Pan();\n } else if (name.indexOf('pinch') > -1) {\n recognizer = new Hammer.Pinch();\n } else if (name.indexOf('press') > -1) {\n recognizer = new Hammer.Press();\n } else if (name.indexOf('rotate') > -1) {\n recognizer = new Hammer.Rotate();\n } else if (name.indexOf('swipe') > -1) {\n recognizer = new Hammer.Swipe();\n } else {\n recognizer = new Hammer.Tap();\n }\n\n manager.add(recognizer);\n return recognizer;\n }\n\n /**\n * Applies certain manager options to individual recognizer options.\n *\n * @param {Object} managerOpts Manager options\n * @param {Object} recognizerOpts Recognizer options\n * @return None\n */\n function applyManagerOptions (managerOpts, recognizerOpts) {\n if (managerOpts) {\n recognizerOpts.preventGhosts = managerOpts.preventGhosts;\n }\n\n return recognizerOpts;\n }\n\n /**\n * Extracts the type of recognizer that should be instantiated from a given\n * event name. Used only when no recognizer options are provided.\n *\n * @param {String} eventName Name to derive the recognizer type from\n * @return {string} Type of recognizer that fires events with that name\n */\n function getRecognizerTypeFromeventName (eventName) {\n if (eventName.indexOf('pan') > -1) {\n return 'pan';\n } else if (eventName.indexOf('pinch') > -1) {\n return 'pinch';\n } else if (eventName.indexOf('press') > -1) {\n return 'press';\n } else if (eventName.indexOf('rotate') > -1) {\n return 'rotate';\n } else if (eventName.indexOf('swipe') > -1) {\n return 'swipe';\n } else if (eventName.indexOf('tap') > -1) {\n return 'tap';\n } else {\n return \"custom\";\n }\n }\n\n /**\n * Applies the passed options object to the appropriate gesture recognizer.\n * Recognizers are created if they do not already exist. See the README for a\n * description of the options object that can be passed to this function.\n *\n * @param {Object} manager Hammer.js manager object assigned to an element\n * @param {Object} options Options applied to a recognizer managed by manager\n * @return None\n */\n function setupRecognizerWithOptions (manager, options, element) {\n if (manager == null || options == null || options.type == null) {\n return console.error('ERROR: Angular Hammer could not setup the' +\n ' recognizer. Values of the passed manager and options: ', manager, options);\n }\n\n var recognizer = manager.get(options._name);\n if (!recognizer) {\n recognizer = addRecognizer(manager, options._name);\n }\n\n if (!options.directions) {\n if (options._name === 'pan' || options._name === 'swipe') {\n options.directions = 'DIRECTION_ALL';\n } else if (options._name.indexOf('left') > -1) {\n options.directions = 'DIRECTION_LEFT';\n } else if (options._name.indexOf('right') > -1) {\n options.directions = 'DIRECTION_RIGHT';\n } else if (options._name.indexOf('up') > -1) {\n options.directions = 'DIRECTION_UP';\n } else if (options._name.indexOf('down') > -1) {\n options.directions = 'DIRECTION_DOWN';\n } else {\n options.directions = '';\n }\n }\n\n options.direction = parseDirections(options.directions);\n recognizer.set(options);\n\n if (typeof options.recognizeWith === 'string') {\n var recognizeWithRecognizer;\n\n if (manager.get(options.recognizeWith) == null){\n recognizeWithRecognizer = addRecognizer(manager, options.recognizeWith);\n }\n\n if (recognizeWithRecognizer != null) {\n recognizer.recognizeWith(recognizeWithRecognizer);\n }\n }\n\n if (typeof options.dropRecognizeWith === 'string' &&\n manager.get(options.dropRecognizeWith) != null) {\n recognizer.dropRecognizeWith(manager.get(options.dropRecognizeWith));\n }\n\n if (typeof options.requireFailure === 'string') {\n var requireFailureRecognizer;\n\n if (manager.get(options.requireFailure) == null){\n requireFailureRecognizer = addRecognizer(manager, {type:options.requireFailure});\n }\n\n if (requireFailureRecognizer != null) {\n recognizer.requireFailure(requireFailureRecognizer);\n }\n }\n\n if (typeof options.dropRequireFailure === 'string' &&\n manager.get(options.dropRequireFailure) != null) {\n recognizer.dropRequireFailure(manager.get(options.dropRequireFailure));\n }\n\n if (options.preventGhosts === true && element != null) {\n preventGhosts(element);\n }\n }\n\n /**\n * Parses the value of the directions property of any Angular Hammer options\n * object and converts them into the standard Hammer.js directions values.\n *\n * @param {String} dirs Direction names separated by '|' characters\n * @return {Number} Hammer.js direction value\n */\n function parseDirections (dirs) {\n var directions = 0;\n\n angular.forEach(dirs.split('|'), function (direction) {\n if (Hammer.hasOwnProperty(direction)) {\n directions = directions | Hammer[direction];\n }\n });\n\n return directions;\n }\n\n // ---- Preventing Ghost Clicks ----\n\n /**\n * Modified from: https://gist.github.com/jtangelder/361052976f044200ea17\n *\n * Prevent click events after a touchend.\n *\n * Inspired/copy-paste from this article of Google by Ryan Fioravanti\n * https://developers.google.com/mobile/articles/fast_buttons#ghost\n */\n\n function preventGhosts (element) {\n if (!element) { return; }\n\n var coordinates = [],\n threshold = 25,\n timeout = 2500;\n\n if ('ontouchstart' in window) {\n element[0].addEventListener('touchstart', resetCoordinates, true);\n element[0].addEventListener('touchend', registerCoordinates, true);\n element[0].addEventListener('click', preventGhostClick, true);\n element[0].addEventListener('mouseup', preventGhostClick, true);\n }\n\n /**\n * prevent clicks if they're in a registered XY region\n * @param {MouseEvent} ev\n */\n function preventGhostClick (ev) {\n for (var i = 0; i < coordinates.length; i++) {\n var x = coordinates[i][0];\n var y = coordinates[i][1];\n\n // within the range, so prevent the click\n if (Math.abs(ev.clientX - x) < threshold &&\n Math.abs(ev.clientY - y) < threshold) {\n ev.stopPropagation();\n ev.preventDefault();\n break;\n }\n }\n }\n\n /**\n * reset the coordinates array\n */\n function resetCoordinates () {\n coordinates = [];\n }\n\n /**\n * remove the first coordinates set from the array\n */\n function popCoordinates () {\n coordinates.splice(0, 1);\n }\n\n /**\n * if it is an final touchend, we want to register it's place\n * @param {TouchEvent} ev\n */\n function registerCoordinates (ev) {\n // touchend is triggered on every releasing finger\n // changed touches always contain the removed touches on a touchend\n // the touches object might contain these also at some browsers (firefox os)\n // so touches - changedTouches will be 0 or lower, like -1, on the final touchend\n if(ev.touches.length - ev.changedTouches.length <= 0) {\n var touch = ev.changedTouches[0];\n coordinates.push([touch.clientX, touch.clientY]);\n\n setTimeout(popCoordinates, timeout);\n }\n }\n }\n})(window, window.angular, window.Hammer);\n
\n \n