git.infodrom.org Git - infodrom.org/service.infodrom.org/blob - src/jquery.event.ue.js

   1 /*
   2  * Jquery plugin for unified mouse and touch events
   3  *
   4  * Copyright (c) 2013 Michael S. Mikowski
   5  * (mike[dot]mikowski[at]gmail[dotcom])
   6  *
   7  * Dual licensed under the MIT or GPL Version 2
   8  * http://jquery.org/license
   9  *
  10  * Versions
  11  *  0.3.0 - Initial jQuery plugin site release
  12  *        - Replaced scrollwheel zoom with drag motion.
  13  *          This resolved a conflict with scrollable areas.
  14  *  0.3.1 - Change for jQuery plugins site
  15  *  0.3.2 - Updated to jQuery 1.9.1.
  16  *          Confirmed 1.7.0-1.9.1 compatibility.
  17  *  0.4.2 - Updated documentation
  18  *  0.4.3 - Removed fatal execption possibility if originalEvent
  19  *          is not defined on event object
  20  *
  21 */
  22
  23 /*jslint           browser : true,   continue : true,
  24   devel  : true,    indent : 2,       maxerr  : 50,
  25   newcap : true,  plusplus : true,    regexp  : true,
  26   sloppy : true,      vars : true,     white  : true
  27 */
  28 /*global jQuery, sl */
  29
  30 (function ( $ ) {
  31   //---------------- BEGIN MODULE SCOPE VARIABLES --------------
  32   var
  33     $Special        = $.event.special,  // shortcut for special event
  34     motionMapMap    = {},         // map of pointer motions by cursor
  35     isMoveBound     = false,      // flag if move handlers bound
  36     pxPinchZoom     = -1,         // distance between pinch-zoom points
  37     optionKey       = 'ue_bound', // data key for storing options
  38     doDisableMouse  = false,      // flag to discard mouse input
  39     defaultOptMap   = {           // Default option hash
  40       bound_ns_map  : {},         // namspace hash e.g. bound_ns_map.utap.fred
  41       wheel_ratio   : 15,         // multiplier for mousewheel delta
  42       px_radius     : 3,          // 'distance' dragged before dragstart
  43       ignore_class  : ':input',   // 'not' suppress matching elements
  44       tap_time      : 200,        // millisecond max time to consider tap
  45       held_tap_time : 300         // millisecond min time to consider taphold
  46     },
  47     callbackList  = [],           // global callback stack
  48     zoomMouseNum  = 1,            // multiplier for mouse zoom
  49     zoomTouchNum  = 4,            // multiplier for touch zoom
  50
  51     boundList, Ue,
  52     motionDragId,  motionHeldId, motionDzoomId,
  53     motion1ZoomId, motion2ZoomId,
  54
  55     checkMatchVal, removeListVal,  pushUniqVal,   makeListPlus,
  56     fnHeld,        fnMotionStart,  fnMotionMove,
  57     fnMotionEnd,   onMouse,        onTouch,
  58     onMousewheel
  59     ;
  60   //----------------- END MODULE SCOPE VARIABLES ---------------
  61
  62   //------------------- BEGIN UTILITY METHODS ------------------
  63   // Begin utiltity /makeListPlus/
  64   // Returns an array with much desired methods:
  65   //   * remove_val(value) : remove element that matches
  66   //     the provided value. Returns number of elements
  67   //     removed.
  68   //   * match_val(value)  : shows if a value exists
  69   //   * push_uniq(value)  : pushes a value onto the stack
  70   //     iff it does not already exist there
  71   // Note: the reason I need this is to compare objects to
  72   //   objects (perhaps jQuery has something similar?)
  73   checkMatchVal = function ( data ) {
  74     var match_count = 0, idx;
  75     for ( idx = this.length; idx; 0 ) {
  76       if ( this[--idx] === data ) { match_count++; }
  77     }
  78     return match_count;
  79   };
  80   removeListVal = function ( data ) {
  81     var removed_count = 0, idx;
  82     for ( idx = this.length; idx; 0 ) {
  83       if ( this[--idx] === data ) {
  84         this.splice(idx, 1);
  85         removed_count++;
  86         idx++;
  87       }
  88     }
  89     return removed_count;
  90   };
  91   pushUniqVal = function ( data ) {
  92     if ( checkMatchVal.call(this, data ) ) { return false; }
  93     this.push( data );
  94     return true;
  95   };
  96   // primary utility
  97   makeListPlus = function ( input_list ) {
  98     if ( input_list && $.isArray(input_list) ) {
  99       if ( input_list.remove_val ) {
 100         console.warn( 'The array appears to already have listPlus capabilities' );
 101         return input_list;
 102       }
 103     }
 104     else {
 105       input_list = [];
 106     }
 107     input_list.remove_val = removeListVal;
 108     input_list.match_val  = checkMatchVal;
 109     input_list.push_uniq  = pushUniqVal;
 110
 111     return input_list;
 112   };
 113   // End utility /makeListPlus/
 114   //-------------------- END UTILITY METHODS -------------------
 115
 116   //--------------- BEGIN JQUERY SPECIAL EVENTS ----------------
 117   // Unique array for bound objects
 118   boundList = makeListPlus();
 119
 120   // Begin define special event handlers
 121   Ue = {
 122     setup : function( data, a_names, fn_bind ) {
 123       var
 124         this_el     = this,
 125         $to_bind    = $(this_el),
 126         seen_map    = {},
 127         option_map, idx, namespace_key, ue_namespace_code, namespace_list
 128         ;
 129
 130       // if previous related event bound do not rebind, but do add to
 131       // type of event bound to this element, if not already noted
 132       if ( $.data( this, optionKey ) ) { return; }
 133
 134       option_map = {};
 135       $.extend( true, option_map, defaultOptMap );
 136       $.data( this_el, optionKey, option_map );
 137
 138       namespace_list = makeListPlus(a_names.slice(0));
 139       if ( ! namespace_list.length
 140         || namespace_list[0] === ""
 141       ) { namespace_list = ["000"]; }
 142
 143       NSPACE_00:
 144       for ( idx = 0; idx < namespace_list.length; idx++ ) {
 145         namespace_key = namespace_list[idx];
 146
 147         if ( ! namespace_key ) { continue NSPACE_00; }
 148         if ( seen_map.hasOwnProperty(namespace_key) ) { continue NSPACE_00; }
 149
 150         seen_map[namespace_key] = true;
 151
 152         ue_namespace_code = '.__ue' + namespace_key;
 153
 154         $to_bind.bind( 'mousedown'  + ue_namespace_code, onMouse  );
 155         $to_bind.bind( 'touchstart' + ue_namespace_code, onTouch );
 156         $to_bind.bind( 'mousewheel' + ue_namespace_code, onMousewheel );
 157       }
 158
 159       boundList.push_uniq( this_el ); // record as bound element
 160
 161       if ( ! isMoveBound ) {
 162         // console.log('first element bound - adding global binds');
 163         $(document).bind( 'mousemove.__ue',   onMouse );
 164         $(document).bind( 'touchmove.__ue',   onTouch );
 165         $(document).bind( 'mouseup.__ue'  ,   onMouse );
 166         $(document).bind( 'touchend.__ue' ,   onTouch );
 167         $(document).bind( 'touchcancel.__ue', onTouch );
 168         isMoveBound = true;
 169       }
 170     },
 171
 172     // arg_map.type = string - name of event to bind
 173     // arg_map.data = poly - whatever (optional) data was passed when binding
 174     // arg_map.namespace = string - A sorted, dot-delimited list of namespaces
 175     //   specified when binding the event
 176     // arg_map.handler  = fn - the event handler the developer wishes to be bound
 177     //   to the event.  This function should be called whenever the event
 178     //   is triggered
 179     // arg_map.guid = number - unique ID for event handler, provided by jQuery
 180     // arg_map.selector = string - selector used by 'delegate' or 'live' jQuery
 181     //   methods.  Only available when these methods are used.
 182     //
 183     // this - the element to which the event handler is being bound
 184     // this always executes immediate after setup (if first binding)
 185     add : function ( arg_map ) {
 186       var
 187         this_el         = this,
 188         option_map      = $.data( this_el, optionKey ),
 189         namespace_str   = arg_map.namespace,
 190         event_type      = arg_map.type,
 191         bound_ns_map, namespace_list, idx, namespace_key
 192         ;
 193       if ( ! option_map ) { return; }
 194
 195       bound_ns_map  = option_map.bound_ns_map;
 196
 197       if ( ! bound_ns_map[event_type] ) {
 198         // this indicates a non-namespaced entry
 199         bound_ns_map[event_type] = {};
 200       }
 201
 202       if ( ! namespace_str ) { return; }
 203
 204       namespace_list = namespace_str.split('.');
 205
 206       for ( idx = 0; idx < namespace_list.length; idx++ ) {
 207         namespace_key = namespace_list[idx];
 208         bound_ns_map[event_type][namespace_key] = true;
 209       }
 210     },
 211
 212     remove : function ( arg_map ) {
 213       var
 214         elem_bound     = this,
 215         option_map     = $.data( elem_bound, optionKey ),
 216         bound_ns_map   = option_map.bound_ns_map,
 217         event_type     = arg_map.type,
 218         namespace_str  = arg_map.namespace,
 219         namespace_list, idx, namespace_key
 220         ;
 221
 222       if ( ! bound_ns_map[event_type] ) { return; }
 223
 224       // No namespace(s) provided:
 225       // Remove complete record for custom event type (e.g. utap)
 226       if ( ! namespace_str ) {
 227         delete bound_ns_map[event_type];
 228         return;
 229       }
 230
 231       // Namespace(s) provided:
 232       // Remove namespace flags from each custom event typei (e.g. utap)
 233       // record.  If all claimed namespaces are removed, remove
 234       // complete record.
 235       namespace_list = namespace_str.split('.');
 236
 237       for ( idx = 0; idx < namespace_list.length; idx++ ) {
 238         namespace_key = namespace_list[idx];
 239         if (bound_ns_map[event_type][namespace_key]) {
 240           delete bound_ns_map[event_type][namespace_key];
 241         }
 242       }
 243
 244       if ( $.isEmptyObject( bound_ns_map[event_type] ) ) {
 245         delete bound_ns_map[event_type];
 246       }
 247     },
 248
 249     teardown : function( a_names ) {
 250       var
 251         elem_bound   = this,
 252         $bound       = $(elem_bound),
 253         option_map   = $.data( elem_bound, optionKey ),
 254         bound_ns_map = option_map.bound_ns_map,
 255         idx, namespace_key, ue_namespace_code, namespace_list
 256         ;
 257
 258       // do not tear down if related handlers are still bound
 259       if ( ! $.isEmptyObject( bound_ns_map ) ) { return; }
 260
 261       namespace_list = makeListPlus(a_names);
 262       namespace_list.push_uniq('000');
 263
 264       NSPACE_01:
 265       for ( idx = 0; idx < namespace_list.length; idx++ ) {
 266         namespace_key = namespace_list[idx];
 267
 268         if ( ! namespace_key ) { continue NSPACE_01; }
 269
 270         ue_namespace_code = '.__ue' + namespace_key;
 271         $bound.unbind( 'mousedown'  + ue_namespace_code );
 272         $bound.unbind( 'touchstart' + ue_namespace_code );
 273         $bound.unbind( 'mousewheel' + ue_namespace_code );
 274       }
 275
 276       $.removeData( elem_bound, optionKey );
 277
 278       // Unbind document events only after last element element is removed
 279       boundList.remove_val(this);
 280       if ( boundList.length === 0 ) {
 281         // console.log('last bound element removed - removing global binds');
 282         $(document).unbind( 'mousemove.__ue');
 283         $(document).unbind( 'touchmove.__ue');
 284         $(document).unbind( 'mouseup.__ue');
 285         $(document).unbind( 'touchend.__ue');
 286         $(document).unbind( 'touchcancel.__ue');
 287         isMoveBound = false;
 288       }
 289     }
 290   };
 291   // End define special event handlers
 292   //--------------- BEGIN JQUERY SPECIAL EVENTS ----------------
 293
 294   //------------------ BEGIN MOTION CONTROLS -------------------
 295   // Begin motion control /fnHeld/
 296   fnHeld = function ( arg_map ) {
 297     var
 298       timestamp         = +new Date(),
 299       motion_id    = arg_map.motion_id,
 300       motion_map   = arg_map.motion_map,
 301       bound_ns_map = arg_map.bound_ns_map,
 302       event_ue
 303       ;
 304
 305     delete motion_map.idto_tapheld;
 306
 307     if ( ! motion_map.do_allow_tap ) { return; }
 308
 309     motion_map.px_end_x     = motion_map.px_start_x;
 310     motion_map.px_end_y     = motion_map.px_start_y;
 311     motion_map.ms_timestop  = timestamp;
 312     motion_map.ms_elapsed   = timestamp - motion_map.ms_timestart;
 313
 314     if ( bound_ns_map.uheld ) {
 315       event_ue     = $.Event('uheld');
 316       $.extend( event_ue, motion_map );
 317       $(motion_map.elem_bound).trigger(event_ue);
 318     }
 319
 320     // remove tracking, as we want no futher action on this motion
 321     if ( bound_ns_map.uheldstart ) {
 322       event_ue     = $.Event('uheldstart');
 323       $.extend( event_ue, motion_map );
 324       $(motion_map.elem_bound).trigger(event_ue);
 325       motionHeldId = motion_id;
 326     }
 327     else {
 328       delete motionMapMap[motion_id];
 329     }
 330   };
 331   // End motion control /fnHeld/
 332
 333
 334   // Begin motion control /fnMotionStart/
 335   fnMotionStart = function ( arg_map ) {
 336     var
 337       motion_id      = arg_map.motion_id,
 338       event_src      = arg_map.event_src,
 339       request_dzoom  = arg_map.request_dzoom,
 340
 341       option_map     = $.data( arg_map.elem, optionKey ),
 342       bound_ns_map   = option_map.bound_ns_map,
 343       $target        = $(event_src.target ),
 344       do_zoomstart   = false,
 345       motion_map, cb_map, do_allow_tap, event_ue
 346       ;
 347
 348     // this should never happen, but it does
 349     if ( motionMapMap[ motion_id ] ) { return; }
 350
 351     if ( request_dzoom && ! bound_ns_map.uzoomstart ) { return; }
 352
 353     // :input selector includes text areas
 354     if ( $target.is( option_map.ignore_class ) ) { return; }
 355
 356     do_allow_tap = bound_ns_map.utap
 357       || bound_ns_map.uheld || bound_ns_map.uheldstart
 358       ? true : false;
 359
 360     cb_map = callbackList.pop();
 361
 362     while ( cb_map ) {
 363       if ( $target.is( cb_map.selector_str )
 364         || $( arg_map.elem ).is( cb_map.selector_str )
 365       ) {
 366         if ( cb_map.callback_match ) {
 367           cb_map.callback_match( arg_map );
 368         }
 369       }
 370       else {
 371         if ( cb_map.callback_nomatch ) {
 372           cb_map.callback_nomatch( arg_map );
 373         }
 374       }
 375       cb_map = callbackList.pop();
 376     }
 377
 378     motion_map = {
 379       do_allow_tap : do_allow_tap,
 380       elem_bound   : arg_map.elem,
 381       elem_target  : event_src.target,
 382       ms_elapsed   : 0,
 383       ms_timestart : event_src.timeStamp,
 384       ms_timestop  : undefined,
 385       option_map   : option_map,
 386       orig_target  : event_src.target,
 387       px_current_x : event_src.clientX,
 388       px_current_y : event_src.clientY,
 389       px_end_x     : undefined,
 390       px_end_y     : undefined,
 391       px_start_x   : event_src.clientX,
 392       px_start_y   : event_src.clientY,
 393       timeStamp    : event_src.timeStamp
 394     };
 395
 396     motionMapMap[ motion_id ] = motion_map;
 397
 398     if ( bound_ns_map.uzoomstart ) {
 399       if ( request_dzoom ) {
 400         motionDzoomId = motion_id;
 401       }
 402       else if ( ! motion1ZoomId ) {
 403         motion1ZoomId = motion_id;
 404       }
 405       else if ( ! motion2ZoomId ) {
 406         motion2ZoomId = motion_id;
 407         event_ue = $.Event('uzoomstart');
 408         do_zoomstart = true;
 409       }
 410
 411       if ( do_zoomstart ) {
 412         event_ue = $.Event( 'uzoomstart' );
 413         motion_map.px_delta_zoom = 0;
 414         $.extend( event_ue, motion_map );
 415         $(motion_map.elem_bound).trigger(event_ue);
 416         return;
 417       }
 418     }
 419
 420     if ( bound_ns_map.uheld || bound_ns_map.uheldstart ) {
 421       motion_map.idto_tapheld = setTimeout(
 422         function() {
 423           fnHeld({
 424             motion_id  : motion_id,
 425             motion_map   : motion_map,
 426             bound_ns_map : bound_ns_map
 427           });
 428         },
 429         option_map.held_tap_time
 430       );
 431     }
 432   };
 433   // End motion control /fnMotionStart/
 434
 435   // Begin motion control /fnMotionMove/
 436   fnMotionMove  = function ( arg_map ) {
 437     var
 438       motion_id   = arg_map.motion_id,
 439       event_src   = arg_map.event_src,
 440       do_zoommove = false,
 441       motion_map, option_map, bound_ns_map,
 442       event_ue, px_pinch_zoom, px_delta_zoom,
 443       mzoom1_map, mzoom2_map
 444       ;
 445
 446     if ( ! motionMapMap[motion_id] ) { return; }
 447
 448     motion_map   = motionMapMap[motion_id];
 449     option_map   = motion_map.option_map;
 450     bound_ns_map = option_map.bound_ns_map;
 451
 452     motion_map.timeStamp    = event_src.timeStamp;
 453     motion_map.elem_target  = event_src.target;
 454     motion_map.ms_elapsed   = event_src.timeStamp - motion_map.ms_timestart;
 455
 456     motion_map.px_delta_x   = event_src.clientX - motion_map.px_current_x;
 457     motion_map.px_delta_y   = event_src.clientY - motion_map.px_current_y;
 458
 459     motion_map.px_current_x = event_src.clientX;
 460     motion_map.px_current_y = event_src.clientY;
 461
 462     // native event object override
 463     motion_map.timeStamp    = event_src.timeStamp;
 464
 465     // disallow tap if outside of zone or time elapsed
 466     // we use this for other events, so we do it every time
 467     if ( motion_map.do_allow_tap ) {
 468       if ( Math.abs(motion_map.px_delta_x) > option_map.px_radius
 469         || Math.abs(motion_map.pd_delta_y) > option_map.px_radius
 470         || motion_map.ms_elapsed           > option_map.tap_time
 471       ) { motion_map.do_allow_tap = false; }
 472     }
 473
 474     if ( motion1ZoomId && motion2ZoomId
 475       && ( motion_id === motion1ZoomId
 476         || motion_id === motion2ZoomId
 477     )) {
 478       motionMapMap[motion_id] = motion_map;
 479       mzoom1_map = motionMapMap[motion1ZoomId];
 480       mzoom2_map = motionMapMap[motion2ZoomId];
 481
 482       px_pinch_zoom = Math.floor(
 483         Math.sqrt(
 484             Math.pow((mzoom1_map.px_current_x - mzoom2_map.px_current_x),2)
 485           + Math.pow((mzoom1_map.px_current_y - mzoom2_map.px_current_y),2)
 486         ) +0.5
 487       );
 488
 489       if ( pxPinchZoom === -1 ) { px_delta_zoom = 0; }
 490       else { px_delta_zoom = ( px_pinch_zoom - pxPinchZoom ) * zoomTouchNum;}
 491
 492       // save value for next iteration delta comparison
 493       pxPinchZoom  = px_pinch_zoom;
 494       do_zoommove  = true;
 495     }
 496     else if ( motionDzoomId === motion_id ) {
 497       if ( bound_ns_map.uzoommove ) {
 498         px_delta_zoom = motion_map.px_delta_y * zoomMouseNum;
 499         do_zoommove = true;
 500       }
 501     }
 502
 503     if ( do_zoommove ){
 504       event_ue = $.Event('uzoommove');
 505       motion_map.px_delta_zoom = px_delta_zoom;
 506       $.extend( event_ue, motion_map );
 507       $(motion_map.elem_bound).trigger(event_ue);
 508       return;
 509     }
 510
 511     if ( motionHeldId === motion_id ) {
 512       if ( bound_ns_map.uheldmove ) {
 513         event_ue = $.Event('uheldmove');
 514         $.extend( event_ue, motion_map );
 515         $(motion_map.elem_bound).trigger(event_ue);
 516         event_src.preventDefault();
 517       }
 518     }
 519     else if ( motionDragId === motion_id ) {
 520       if ( bound_ns_map.udragmove ) {
 521         event_ue = $.Event('udragmove');
 522         $.extend( event_ue, motion_map );
 523         $(motion_map.elem_bound).trigger(event_ue);
 524         event_src.preventDefault();
 525       }
 526     }
 527
 528     if ( ! motionDragId
 529       && ! motionHeldId
 530       && bound_ns_map.udragstart
 531       && motion_map.do_allow_tap === false
 532     ) {
 533       motionDragId = motion_id;
 534       event_ue = $.Event('udragstart');
 535       $.extend( event_ue, motion_map );
 536       $(motion_map.elem_bound).trigger(event_ue);
 537       event_src.preventDefault();
 538
 539       if ( motion_map.idto_tapheld ) {
 540         clearTimeout(motion_map.idto_tapheld);
 541         delete motion_map.idto_tapheld;
 542       }
 543     }
 544   };
 545   // End motion control /fnMotionMove/
 546
 547   // Begin motion control /fnMotionEnd/
 548   fnMotionEnd   = function ( arg_map ) {
 549     var
 550       motion_id    = arg_map.motion_id,
 551       event_src    = arg_map.event_src,
 552       do_zoomend   = false,
 553       motion_map, option_map, bound_ns_map, event_ue
 554       ;
 555
 556     doDisableMouse = false;
 557
 558     if ( ! motionMapMap[motion_id] ) { return; }
 559
 560     motion_map   = motionMapMap[motion_id];
 561     option_map   = motion_map.option_map;
 562     bound_ns_map = option_map.bound_ns_map;
 563
 564     motion_map.elem_target  = event_src.target;
 565     motion_map.ms_elapsed   = event_src.timeStamp - motion_map.ms_timestart;
 566     motion_map.ms_timestop  = event_src.timeStamp;
 567
 568     if ( motion_map.px_current_x ) {
 569       motion_map.px_delta_x   = event_src.clientX - motion_map.px_current_x;
 570       motion_map.px_delta_y   = event_src.clientY - motion_map.px_current_y;
 571     }
 572
 573     motion_map.px_current_x = event_src.clientX;
 574     motion_map.px_current_y = event_src.clientY;
 575
 576     motion_map.px_end_x     = event_src.clientX;
 577     motion_map.px_end_y     = event_src.clientY;
 578
 579     // native event object override
 580     motion_map.timeStamp    = event_src.timeStamp
 581     ;
 582
 583     // clear-out any long-hold tap timer
 584     if ( motion_map.idto_tapheld ) {
 585       clearTimeout(motion_map.idto_tapheld);
 586       delete motion_map.idto_tapheld;
 587     }
 588
 589     // trigger utap
 590     if ( bound_ns_map.utap
 591       && motion_map.ms_elapsed   <= option_map.tap_time
 592       && motion_map.do_allow_tap
 593     ) {
 594       event_ue = $.Event('utap');
 595       $.extend( event_ue, motion_map );
 596       $(motion_map.elem_bound).trigger(event_ue);
 597     }
 598
 599     // trigger udragend
 600     if ( motion_id === motionDragId ) {
 601       if ( bound_ns_map.udragend ) {
 602         event_ue = $.Event('udragend');
 603         $.extend( event_ue, motion_map );
 604         $(motion_map.elem_bound).trigger(event_ue);
 605         event_src.preventDefault();
 606       }
 607       motionDragId = undefined;
 608     }
 609
 610     // trigger heldend
 611     if ( motion_id === motionHeldId ) {
 612       if ( bound_ns_map.uheldend ) {
 613         event_ue = $.Event('uheldend');
 614         $.extend( event_ue, motion_map );
 615         $(motion_map.elem_bound).trigger(event_ue);
 616       }
 617       motionHeldId = undefined;
 618     }
 619
 620     // trigger uzoomend
 621     if ( motion_id === motionDzoomId ) {
 622       do_zoomend = true;
 623       motionDzoomId = undefined;
 624     }
 625
 626     // cleanup zoom info
 627     else if ( motion_id === motion1ZoomId ) {
 628       if ( motion2ZoomId ) {
 629         motion1ZoomId = motion2ZoomId;
 630         motion2ZoomId = undefined;
 631         do_zoomend = true;
 632       }
 633       else { motion1ZoomId = undefined; }
 634       pxPinchZoom  = -1;
 635     }
 636     if ( motion_id === motion2ZoomId ) {
 637       motion2ZoomId = undefined;
 638       pxPinchZoom  = -1;
 639       do_zoomend   = true;
 640     }
 641
 642     if ( do_zoomend && bound_ns_map.uzoomend ) {
 643       event_ue = $.Event('uzoomend');
 644       motion_map.px_delta_zoom = 0;
 645       $.extend( event_ue, motion_map );
 646       $(motion_map.elem_bound).trigger(event_ue);
 647     }
 648     // remove pointer from consideration
 649     delete motionMapMap[motion_id];
 650   };
 651   // End motion control /fnMotionEnd/
 652   //------------------ END MOTION CONTROLS -------------------
 653
 654  //------------------- BEGIN EVENT HANDLERS -------------------
 655   // Begin event handler /onTouch/ for all touch events.
 656   // We use the 'type' attribute to dispatch to motion control
 657   onTouch = function ( event ) {
 658     var
 659       this_el     = this,
 660       timestamp   = +new Date(),
 661       o_event     = event.originalEvent,
 662       touch_list  = o_event ? o_event.changedTouches || [] : [],
 663       touch_count = touch_list.length,
 664       idx, touch_event, motion_id, handler_fn
 665       ;
 666
 667     doDisableMouse = true;
 668
 669     event.timeStamp = timestamp;
 670
 671     switch ( event.type ) {
 672       case 'touchstart' :
 673         handler_fn = fnMotionStart;
 674         event.preventDefault();
 675       break;
 676       case 'touchmove'  :
 677         handler_fn = fnMotionMove;
 678       break;
 679       case 'touchend'    :
 680       case 'touchcancel' : handler_fn = fnMotionEnd;   break;
 681       default : handler_fn = null;
 682     }
 683
 684     if ( ! handler_fn ) { return; }
 685
 686     for ( idx = 0; idx < touch_count; idx++ ) {
 687       touch_event  = touch_list[idx];
 688
 689       motion_id = 'touch' + String(touch_event.identifier);
 690
 691       event.clientX   = touch_event.clientX;
 692       event.clientY   = touch_event.clientY;
 693       handler_fn({
 694         elem      : this_el,
 695         motion_id : motion_id,
 696         event_src : event
 697       });
 698     }
 699   };
 700   // End event handler /onTouch/
 701
 702
 703   // Begin event handler /onMouse/ for all mouse events
 704   // We use the 'type' attribute to dispatch to motion control
 705   onMouse = function ( event ) {
 706     var
 707       this_el       = this,
 708       motion_id     = 'mouse' + String(event.button),
 709       request_dzoom = false,
 710       handler_fn
 711       ;
 712
 713     if ( doDisableMouse ) {
 714       event.stopImmediatePropagation();
 715       return;
 716     }
 717
 718     if ( event.shiftKey ) { request_dzoom  =  true; }
 719
 720     // skip left or middle clicks
 721     if ( event.type !== 'mousemove' ) {
 722       if ( event.button !== 0 ) { return true; }
 723     }
 724
 725     switch ( event.type ) {
 726       case 'mousedown' :
 727         handler_fn = fnMotionStart;
 728         event.preventDefault();
 729         break;
 730       case 'mouseup'   :
 731         handler_fn = fnMotionEnd;
 732         break;
 733       case 'mousemove' :
 734         handler_fn = fnMotionMove;
 735         break;
 736       default:
 737         handler_fn = null;
 738     }
 739
 740     if ( ! handler_fn ) { return; }
 741
 742     handler_fn({
 743       elem          : this_el,
 744       event_src     : event,
 745       request_dzoom : request_dzoom,
 746       motion_id     : motion_id
 747     });
 748   };
 749   // End event handler /onMouse/
 750   //-------------------- END EVENT HANDLERS --------------------
 751
 752
 753   // Export special events through jQuery API
 754   $Special.ue
 755     = $Special.utap       = $Special.uheld
 756     = $Special.uzoomstart = $Special.uzoommove = $Special.uzoomend
 757     = $Special.udragstart = $Special.udragmove = $Special.udragend
 758     = $Special.uheldstart = $Special.uheldmove = $Special.uheldend
 759     = Ue
 760     ;
 761   $.ueSetGlobalCb = function ( selector_str, callback_match, callback_nomatch ) {
 762     callbackList.push( {
 763       selector_str     : selector_str     || '',
 764       callback_match   : callback_match   || null,
 765       callback_nomatch : callback_nomatch || null
 766     });
 767   };
 768
 769 }(jQuery));