artabro/wire/modules/Jquery/JqueryCore/jquery.longclick.js

/**
 * jQuery Longclick Event
 * ======================
 * Press & hold mouse button "long click" special event for jQuery 1.4.x
 *
 * @license Longclick Event
 * Copyright (c) 2014 Pascal GANAYE
 * Largely based from from a work Petr Vostrel (http://petr.vostrel.cz/)
 * Dual licensed under the MIT (MIT-LICENSE.txt)
 * and GPL (GPL-LICENSE.txt) licenses.
 *
 * Version: 0.4.0
 * Updated: 2014-10-13
 */

 (function ($) {
    /** `.longclick([ handler ], [ duration ])`
     * If supplied, optional custom `duration` is used for target element(s).
     * This method is a shortcut for `.trigger("longclick")` if called without arguments.
     * Returns *jQuery*.
     */
    $.fn.longclick = function longclick() {
        var handler = arguments[0],
            duration = arguments[1],
            $this = $(this).data(_duration_, duration || null);
        /* Bind long click */
        return handler ? $this.on(type, handler) : $this.trigger(type);
    };

    /**
     *  Configuration
     */
    $.longclick = {
        /**
         * For how long (in milliseconds) mouse button must be pressed down (or touched) stationery
         * to qualify as a *long click*.
         * False value results in using the configured default.
         * Default `duration` is **600** and is stored in `jQuery.longclick.duration` variable.
         */
        duration: 600
    };

    /**
     * Bindings
     */
    $.event.special.longclick = {
        setup: function (data, namespaces) {
            if (!(/iphone|ipad|ipod/i).test(navigator.userAgent)) {
                /* normal technique for standard mouse-based interaction */
                $(this)
                    .on(_mousedown_, schedule)
                    .on([_mouseup_, _mouseout_, _contextmenu_].join(' '), cancel)
                    .on(_click_, click);
            } else {
                /* and special handling for touch-based interaction on iPhone-compatibile devices */
                touch_enabled(this)
                    .on(_touchstart_, schedule)
                    .on([_touchend_, _touchcancel_].join(' '), cancel)
                    .on(_click_, click)
                    .css({WebkitUserSelect: 'none'});
            }
        },
        teardown: function (namespaces) {
            $(this).off(namespace);
        }
    };

    /**
     * Commit subset of touch events to trigger jQuery events of same names
     */
    function touch_enabled(element) {
        $.each('touchstart touchend touchcancel'.split(/ /), function bind(ix, it) {
            element.addEventListener(it, function trigger_jquery_event(event) {
                $(element).trigger(it);
            }, false);
        });
        return $(element);
    }

    /**
     * Handlers
     */
    function schedule(event) {
        /* Check the timer isn't already running and drop if so */
        if ($(this).data(_timer_)) return;
        /* Catch in closure the `this` reference and `arguments` for later */
        var element = this;
        var args = arguments;

            function scheduled() {
                /* Flag as "fired" and rejoin the default event flow */
                $(element).data(_fired_, true)
                    .data(_timer_, null);
                event.type = type;
                var f = (jQuery.event.dispatch || jQuery.event.handle);
                f.apply(element, args);
            }

        /* Flag as "not fired" and schedule the trigger */
        $(this)
            .data(_fired_, false)
            .data(_timer_, setTimeout(scheduled, $(this).data(_duration_) || $.longclick.duration));

    }

    function cancel(event) {
        var timer = $(this).data(_timer_);
        if (timer) {
            /* cancel the scheduled trigger */
            $(this).data(_timer_, clearTimeout(timer) || null);
        }
    }

    function click(event) {
        /* Prevent `click` event to be fired after button release once `longclick` was fired */
        if ($(this).data(_fired_)) return event.stopImmediatePropagation() || false;
    }

    /*
     * Frequent primitives and shortcuts
     */
    var type = 'longclick',
        namespace = '.' + type,

        /* Event strings */
        _mousedown_ = 'mousedown' + namespace,
        _click_ = 'click' + namespace,
        _mouseup_ = 'mouseup' + namespace,
        _mouseout_ = 'mouseout' + namespace,
        _contextmenu_ = 'contextmenu' + namespace,
        _touchstart_ = 'touchstart' + namespace,
        _touchend_ = 'touchend' + namespace,
        _touchcancel_ = 'touchcancel' + namespace,

        /* Storage keys */
        _duration_ = 'duration' + namespace,
        _timer_ = 'timer' + namespace,
        _fired_ = 'fired' + namespace;

})(jQuery);